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source code, of course 

Embedded DOS (full-features, real-time, multitasking, 331-compatible DOS for embedded system and self-bootable installations).$375 

Style (a C+ + class library to build, maintain and traverse arbitrary, non-taxonomic links between C++ objects).$300 

Spell Time (spelling checker for incorporation into text products; no royalty; large dictionary; small and fast).$300 

ZIP Image Processor & Victor Image Library Version 2.2 (brightness, contrast, metge images, TIFF/GIF/PCX/bin, HP ScanJet support) . . $290 

INGRAF (graphics for scientists & engineers, ail sorts of graphs & plots; specify Microsoft or Borland).$275 

The Snooper (Ethernet protocol analyzer for Novell NetWare and LAN Manager Networks; capture packets; real-time display).$275 

HirboTfcX (Release 3.0; HP, PS, dot drivers; CM fonts; LaTgX) Meta Font).$250 

Rogue Wave tools.b-4—f- or math.h++ Class Library (extensive docs).each $240 

InControl Tbolbax(forms package for Windows; validation functions, date/time, regular expression formatted text control).$195 

PxSQL (SQL for Borland's Paradox Engine; ANSI X3.135-1989 SQL^DML standard; network server not required).$180 

c-pslib (PostScript generation library for C programs; includes complete graphics, font, rotation & paragraph support).$170 

C/C+ + Libraries by Code Farms (persistent C structures, ER models, djmamic arrays, disk pger, database functions, much more).$170 

Viewpoint (C+ + graphics library; 32-bit color, pattern fill, scroll & bitmap, coordinate tranformations).$170 

XASM (cross assemblers) .$150 

Minix Operating System (Version 13; Unix-like operating system, includes manual; specify 5.25” or 33” diskettes).$150 

ViewTHeve (relational view of Novell Btrieve databases; includes EZTHeve).$150 

Delorie GCC for MS-DOS (Version 2.2.2; includes C++, assembler, DOS extender, 387 emulation; complete source code and makefiles) . . $150 

Booter Tbolkit (floppy disk bootstrap routines, DOS file system, light-weight multitasking, windows, fast memory management) .$120 

Dr. MD (runtime memory analyzer & debugger; find many memory corruption errors; examine memory usage).$110 

386BSD Version 0.1 & LINUX Version 0.96(two Unix dones for Intel 386).$100 

PCflP (CMU/MIT TCP/IP for PCs; Ciynwr drivers, NFS server, Bdale mailer, PCRoute/PCBridge, NDIS/ODI drivers, Beholder, more) . . . $100 

Demacs (complete GNU Emacs for DOS; needs djgcc to build; based on 18.55).$100 

S cript Interpreter (a command script interpreter for DOS-based systems; C-like script language; lots of features).$90 

NETS Version 3.0 (neural net simulator from COSMIC) .$85 

Ibrow (programmer’s Windows-based editor; large files, help, undo/redo, drag-n-drop, function & type tags).$85 

HorC++ Power (C+ + Class Library for Borland’s Paradox Engine).$80 

ET Neural Net (back error propagation; specify DOS or Windows).$75 

FlexList (doubly-linked lists of arbitrary data with multiple access methods; specify C or C++).$65 

LDBfLcxise Data Binder; persistent data objects for C++; handles pointers between objects) .$60 

Kier DateLib (all kinds of date manipulation; translation, validation, formatting, & arithmetic).$60 

Coder’s Prolog (Version 3.0; inference engine for use with C programs).$60 

PCCTS (Turdue Compiler Construction Tool Set; ported to Microsoft Q like YACC and LEX together with lots of additional features) ... $60 
MEM.WING (global memory manager for Windows, supports standard C memory allocation calls to "wing” your old C code into Windows) . $55 

BigFloat (arbitrary precision floating point arithmetic and functions; includes BCD conversion).$50 

EZCalc (ASCII algebraic expression evaluator, unlimited parenthesis nesting, symbols, 32 built-in functions, easily extended).$50 

Backup & Restore Utility by Blake McBride (multiple volumes, file compression & encryption).$50 

SuperGrep (exceptionally fast, revolutionary text searching algorithm; also searches sub-directories).$50 

Moby Crypto (encryption/decryption routines; Vol.l: DES, Lucifer, SRNG,ARNG; Vol. 2: PGP, RSA, MD4, SHA; both vols. $75) . . . each $50 

OBIASM (convert .obi files to .asm files; output is MASM compatible)..$50 

CLIPS Version 5.1 (rule-based expert system generator; advanced manuals available at additional cost).$50 

NIH Class Library & Book (basic C++ classes & Data Abstraction and Object-Oriented Programming m C+ + in softback by Keith Gorlen) $50 

Editor Pack (20 public domain editors; microEmacs 3.11, Stevie, Elvis, Moke, mg2a, DTE, Jove, Origami, CE & GRIEF).$50 

MicroC C Compiler (retargetable C compiler/optimizer, lots of docs, vety portable, 8086 tables included; tables for 7 extra epu’s $50) .... $50 

PICTOR (I/O library; windows, hypertext, text compression, serial comm, printer support, break handling; text editor example).$45 

TOUR (beautiful traveling salesman problem solver, finds minimum length paths quickly, includes graphics & plotting programs) .$40 

DES Encryption & Decryption (2500 bits/second on 4.77 MHz PC for on-the-fly encryption at 2400 baud; domestic distribution only) .... $40 

Database Pack (9 databases - simple to complex: isam, bplus, AVL, SDB, ID, gdbm, Requiem, Ingres89, Postgres).$35 

COP (poor man’s C++; C macro package which implements C++in C) .$35 

RXC & EGREP Version 2.0 (Regular Expression Compiler and Pattern Matching; finite state machine from regular expression).$35 

Database Pack(9 databases - simple to complex: isam, bplus, AVL, SDB, ID, gdbm, Requiem, Ingres89, Postgres).$35 

Bison & BYACC (YACC workalike parser generators; documentation; includes Cand C++ grammars) .$35 

PASSWORD (password-protect a running PC while you’re away from your desk; includes intrusion log) .$30 

Spell Pack (6 spelling programs, a hyphenator, 2 utility packs and a 60K word list: Ispell, Microsp, Sp, Cspella, Spell, Dawg, Soundex) .... $30 

Alloc-GC (a garbage-collecting memory allocation lilxary).$30 

REGX Plus (Version 2.0, search and replace string manipulation routines based on regular expressions).$30 

GNU Awk & Difif for PC (both programs in one package).$30 

Big Number Pack (7 arbitrary precision arithmetic packages in C, one in Fortran but free Fortran-to-C converter is included) .$30 

Crunch Pack (30 file compression & expansion programs; now includes portable ZIP).$30 

UUPCPackHJUCP for the PQ UUPC Version 1.1 iy smail & snews) .$25 

PERL for MS-DOS (Version 4.019; C, sed, awk, and shell all rolled into one language; indudes hardcopy docs).$25 

FLEX (fast lexical analyzer generator; new, improved LEX; BSD Version 23.6 with docs) .$25 

GNU RCS (FSFs version of the Revision Control System; like Unix’s SCCS only better; keeps track of software development).$20 

PCAL Personal Calendar (generates PostScript calendar for any month or year, lots of options, personalization file for your dates & schedule) $20 

Publisher’s Interchange Language QML Tbol Kit, Version 5.0, API 20 by Quark) .$20 

NetCDF (Network Common Data Form; general-purpose data exchange for scientific data; many tools and programs available).$20 

CPP Pack (3 K&R C preprocessors).$20 

Bywater BASIC Version 1.10 (complete BASIC interpreter and interactive programming environment).$20 

Data 

Moby Thesaurus (25K root words, 1.2M synonyms).$350 

Moby Part-of-Speech (200,000 words and phrases described by prioritized part(s)-of-speech).$120 

Moby Words (500,000 words & phrases, 9,000 stars, 15,000 names).$80 

Moty Shakespeare (plays, sonnets, etc. ... every last word).$60 

Dictionary Word List (234,932 words in alphabetical order).$60 

Roget’s 1911 Thesaurus.$40 

U. S. Cities (names & longitude/latitude of 32000 U.S. cities and 6,000 state boundary points).$35 

CIA World Bank II Database (13MB of maps, 5.7M vectors; ooastlines, rivers, political boundaries; Africa, Asia, Europe, N. & S. America) . $35 

The World Digitized (100,000 longitude/latitude of world oountry boundaries) .$30 

Lots ’O Words (160,086 German, 178,430 Dutch, 61,843 Norwegian, 60,453 Italian, 138,257 French, 53,142 English) .$30 

Tbtt Pack (1990 CIA World Fact Book, Hacker’s Jargon File, Acronyma, Koran, Mormon Scriptures, One Liners, Mnemonics, more) .... $25 

CD-ROMs 

FontMaster Library (soft fonts for HP and HP compatible laser printers, 36 different type faces; 5,200 bit mapped fonts; 300MB).$70 

InfoMagic (X11R5, mhoe 4.3, complete GNU, ISODE, KA9Q & NCSA TCP/IP, Demacs, Djgcc, 386bsd, some GNU on Windows NT) . . . $70 

Prime Time Freeware (over 1 gigabyte of Unix Coode).$60 

Whlnut Creek X11R5 and GNU (X11R5 with contributed and comp.sourcesx, over 120 GNU programs, complete C source).$35 

Whlnut Creek Usenet and Simtel Unix-C (600MB).$35 

Wfeinut Creek Simtel 20 MSDOS Archive (C source code but lots of other stuff too).$20 

The Austin Code Works Voice: (512) 258-0785 

11100 Leafwood Lane much more ... ask for catalog FAX: (512) 258-1342 

Austin, Texas 78750-3587 USA E-mail: info@acw.com 

Free surface shipping for cash in advance For delivery in Texas add 7% MasterCard/VISA 


February 1993 


□ Request 332 on Reader Service Card □ 


Windows/DOS Developer’s Journal - Page 1 








































































February 1993 
Vol. 4, No. 2 


Windows/POS 

□ DEVELOPER'S JOURNAL 



Cover photo by Michel Tcherevkov 
© The Image Bank!Michel Tcherevkov 1988 


Multimedia 


Animation under Windows 3.1. 

Windows does not make smooth animation easy, but this article shows it is possible. 
Thomas W. Olsen 

. .5 

Features 



Automating Help Topic Extraction . 

Add an Extract button to your online help. 

Ron Burk 

Dialog Boxes on the Fly . 

Learn now to create flexible dialog boxes that your users can tailor. 

John Caulfield 

A 3 of 9 Barcode DLL. 

Take advantage of Windows' hardware independence to print barcodes on any high-resolution 
printer. 

Michael Soflin 

Custom Toolbars. 

A package of C routines that make toolbars a piece of cake. 

Mark Szamrej 

ExtendingCOMMAND.COM. 

Don't care for COMMAND.COM? Extend it with your own built-in commands! 

Murray L. Lesser 

1992 Fall COMDEX Report . 

Ron Burk 


Product Spotlight 


Walnut Creek’s CDROMs. 

Can CD-ROM provide you with cost-effective access to network archives? 
Ron Burk 


Book Review _ 

Microsoft C/C++ Programming: The Accessible Guide to Professional 
Programming. . 71 

Reviewed by Massimo Cesaro 


Columns __ 

Tech Tips Leor Zolman . . 58 

Windows tips on Notepad and debugging; a DOS file space allocation measure; and a do-it-yourself 
foot pedal. 

Windows Questions and Answers Paul Bonneau . . . . . 65 

Paul writes a DLL that maintains a per-instance DGROUP. 


Departments _ 

From the Editor. 4 

Call for Papers. 45 

New Products.79 

Source Code Availability. 84 

Developer’s Marketplace. 85 

Advertiser Index. 88 


Next Month .... Turbo Vision Traps and Techniques 


15 

25 

41 

47 

74 

83 


WINDOWS/DOS DEVELOPER’S JOURNAL (ISSN 1059-2407) is published monthly by R&D Publications, Inc., 1601 W. 23rd St., Suite 200, Lawrence, KS 66046-2743, (913) 841-1631. Second- 
class postage paid at Lawrence, KS and additional mailing offices. POSTMASTER: Send address changes to WINDOWS/DOS DEVELOPER’S JOURNAL, 1601 W. 23rd St., Suite 200, Lawrence, 
KS 66046-2743. Subscriptions: Annual renewable subscriptions to WINDOWS/DOS DEVELOPER’S JOURNAL are $29 US, $53 Canada and Mexico, $64 overseas. Payments must be made in US 
dollars. Make checks payable to Windows/DOS Developer’s Journal. 

Page 2 — Windows/DOS Developer’s Journal 


February 1993 















































EarRAt 


A TRUE SPREADSHEET 
CONTROL! 


(THIS IS NOT A GRID!) 


Visual Architect 

for Visual Basic 

“Visual Architect™ is a product 
that no serious Visual Basic devel¬ 
oper can do without.” 

Along with the industry’s 
most powerful and flexible 
true Spreadsheet custom 
control (not a grid!), Visual 
Architect™ features Date 
with Calendar, Time, Float, 

Integer, Formatted PIC and 
View Text controls. 

The Visual Architect™ 
manual is professionally writ¬ 
ten and contains extensive 
documentation. 

Visual Architect™ is only $245.00. 
There are no royalties and of course you 
receive our 30 day, no-hassle, money- 
back guarantee. 


Drover’s Professional 

TOOIBOX for Windows 
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Point’s industry unique full-featured 
spreadsheet control (not a grid!), For¬ 
matted Edit Controls, Tool Bar and 
Status Bar, ability to add 3D effects to 
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tion, and Enhanced Listbox this package 
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Drover’s Professional Toolbox supports 
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Actor, WindowsMaker Pro, Borland 
Resource Workshop and Dialog Editor. 

Drover’s Professional Toolbox for Win¬ 
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royalties and of course you receive our 
30 day no-hassle, money-back guar¬ 
antee. 
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A TRUE SPREADSHEET 
CONTROL. 
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The font, color, and data type may be changed 
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following data types: edit, date, time, integer, 
float, static, formatted pic, combo box, button, 
and picture. Formulas can be added to any cell. 
Editing is performed within the cell. 
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From 

the Editor 


I used to have a coworker who was very much in favor of code reuse. His battle 
cry was "you’re not going to reinvent the wheel are you?" Later, when I worked in a 
UNIX shop, software reuse at the program level was a big theme. Why write a 
function to do something if you could pipe the needed result in from an existing 
program? In fact, I have spent a lot of time reinventing wheels. Someone, some¬ 
where has written something similar to many of the programs I write. “Don’t rein¬ 
vent the wheel" sounds like a good motto, but 1 think there are some common 
cases where it just doesn't hold up. 

Sometimes you want a better wheel. In general, programmers tend to be over¬ 
ly concerned with efficiency at the microscopic level, but sometimes not reinventing 
the wheel really is too slow. I think it’s neat that you can build a relational database 
out of sequential UNIX tools like awk, but I want the database that I access many 
times each day to have a snappier response than that. The more often I use a 
wheel, the more likely that reinventing it will become an attractive proposition. 

Sometimes nobody else's wheel fits. Windows is designed for device inde¬ 
pendent printing and Microsoft provides a plethora of printer drivers. Surely no one 
needs to write printer-specific Windows code anymore, right? Wrong. When you 
need to get the absolute best results from the printer at hand, you may find that 
the Windows printer driver just isn't up to the task. For example, if you need to 
produce the best quality bitmapped images on a PostScript printer from Windows, 
you may have to reinvent the wheel. 

Sometimes you want to learn how to make wheels. When I was in college, I 
took the documentation for Lex (a UNIX tool for creating lexical analyzers) and wrote 
my own version in B. Obviously, someone else had already written this program in C, 
and my B version never got used by more than a couple of programmers — what 
could be a better example of why you should never reinvent the wheel? In fart, that 
summer I spent writing the code, constructing and minimizing countless state 
machines by hand to verify the algorithms and output of the program, all worked to 
give me an understanding of automata that I've drawn on over and over in the 
years since. Sometimes the best way to gain a solid understanding of programming 
concepts is to sit down and reinvent some wheels. 

Reinventing the software wheel isn't always a bad thing. The fart is, the human 
race has been reinventing the wheel ever since someone stuck that first stone circle 
on that first wooden axle. We didn't stop with discovering vulcanized rubber, and 
we haven’t stopped with steel-belted radials, and the result is a better ride for 
everyone. 


Ron Burk 

Editor 

CIS: 70302,2566 ; BIX: rlburk ; Internet: ronb@rdpub.com ("... !uunet!rdpub!ronb“) 
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Multimedia 


Animation under 
Windows 3.1 


Thomas W. Olsen 


Over sixty years ago, a young Walt Disney flipped the pages of his sketchbook 
and witnessed the birth of an unusual but revolutionary little mouse. Since that 
time, animation has leapt from the sketchpad into a thriving marriage of film and 
computer technologies, as seen in recent movies like Terminator 2 and The 
Lawnmower Man. Computer software perfoms much of the work that once required 
dozens of studio artists. Companies like Disney, LucasFilm, and Industrial Light & 
Magic have all developed custom animation software to enhance the realism of their 
special effects arsenals. Several of those companies now offer similar commercial 
software for Microsoft Windows. While Windows poses no immediate threat to high- 
end graphics workstations, it can nonetheless produce simple kinds of animation 
suitable for demos, tutorials, and business presentations. 

Tools and Techniques 

Developing animation software is straightforward but painstaking work. It's really 
a choice between using the Microsoft Multimedia Development Kit (MDK) and writing 
your own stuff. Like the emperor's new clothes, something seems to be missing 
from the MDK. Sure, you get tools for editing bitmaps, the color palette, and .wav 
files, a file converter, and various multimedia device drivers and DLLs. Microsoft even 
furnishes a high-level script language called Media Control interface (MCI) that plays 
audio and video sequences without the need for programming. The Windows 3.1 
Media Player can play MCI scripts, too. Applications can also call a number of 
equivalent low-level MDK functions for more precise control. There’s just one prob¬ 
lem: it doesn’t contain a movie authoring tool! Irony aside, Microsoft recommends 
developing movies on an Apple Macintosh equipped with MacroMind Director 
software, and porting them to the PC. Those of you lacking the good fortune (or 
original foresight) to own a Macintosh are left to your own designs, for the time 
being. 

Regardless of platform, animation possesses certain inherent characteristics. 
''Frame-based" animation displays pictures or “frames” in rapid succession — fast 
enough to create an illusion of fluid motion. “Cast-based" animation, on the other 
hand, takes a number of individual objects or actors and blends them into a frame. 
Each actor has a particular location, size, and appearance within a frame. One of the 
great advantages of cast-based animation is that actors can be reused, since they 

are wholly separate from the frames. The price for this 
extra capability is slower processing time — the CPU 
has to handle a lot more data - and greater com¬ 
plexity - the actor must blend seamlessly into any 
frame background. 


= 03 = 

Microsoft C/C++ v7.0a 

— 

Borland C++v3.1 


Thomas Olsen writes a variety of Windows and DOS software for a major insurance 
company. He can be reached on CompuServe at (76450,1767). 
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► Real & protected mode 16-hit support 
• 32-bit protected mode support 

» Wide range of graphic adapter support 

► Virtual screens 

» Multiple simultaneous graphics adapters 
» BGI interface available 

$250, No Royalties 



X-32VM 32-hit DOS Extender 

• l Ip to 3.5 gigabytes of virtual memory 

• l Mtra compact, self-contained executables 

• Fully compatible with Zortech's DOSX 
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• Flash Graphics and FlashView compatible 
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Source level debugger for C ++ , C and 
assembler programs. 

Easy to use expansion of classes, 
structures, pointers, arrays, etc. 

Powerful run-time memory' protection 

detects pointer bugs 

Full nested call traceback display with 

automatics and parameters 

Unlimited number of break and trace poirtts 

History buffer for recording up to 

32,000 source lines and variables 

Program execution time recording for 

timing analyses 

Dual monitor debugging 


FlashTek is proud to offer former Zortech 
products, by the original authors, now with 
support for other compilers. New' features, 
fantastic support, no royalties, and great 

nrir»ps 

ORDERS 800-397-7310 


FlashTek Inc Murray Communications 

1 21 Sweet Avc. 53 Harrowhy I.ane 
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At bottom, both actors and frames 
are nothing more than rectangular bit¬ 
maps. Fortunately, Windows provides a 
convenient mechanism for manipulating 
and displaying bitmaps in the BitBltf) 
function. BitBlt() supports a rich 
variety of raster operations (AND, X0R, 


OR, COPY, etc.) and interesting color in¬ 
teractions. The problem with BitBltf) 
is that it copies only rectangular bitmaps, 
but most of the images you want to 
animate will have irregular shapes. 

Icons are rectangular bitmaps, but the 
icon does not always look rectangular. 


Listing 1 Sprite animation in Windows 3.1 


linclude <math.h> 
finclude <memory.h> 
finclude <stdarg.h> 
finclude "windows.h" 

J****************************************************************************J 


/*Title: SPRITES.C */ 

/‘Author: Thomas W. Olsen */ 

/‘Version: 1.0 */ 

/‘Compiler: Microsoft C/C++ 7.0 */ 

/* rc /r sprites.rc */ 

/* cl /c /AM /Gsw /W3 /Oas /Zpe /Zi /DSTRICT /DWINVER=0x0300 sprites.c */ 

/* link /CO /NOD sprites,,, libw mlibcew, sprites.def */ 

/* rc sprites.res sprites.exe */ 

I****************************************************************************I 

/* Constants */ 


^**************************************************************************** j 

Idefine TIMERJD 1 

Idefine TIMER RESOLUTION 50 


/***********★*★********★** 


*******/ 


Structure Definitions 


********* 


r **************************************************/ 


typedef struct tagCEL 
/ 

I 

struct tagCEL ‘IpPrev; 
struct tagCEL ‘lpNext; 

BOOL 

visible; 

POINT 

dimension; 

POINT 

position; 

HBITMAP 

hMaskBitmap 

HBITMAP 

hCelBitmap; 

} CEL; 


typedef CEL 

‘LPCEL; 


typedef struct tagSPRITE 

I 


WORD 

numCels; 

LPCEL 

lpCel; 

DWORD 

delayTicks 

DWORD 

elapsedTic 

SPRITE; 



typedef SPRITE ‘LPSPRITE; 


/* Dimensions of Cel */ 

/* Position of Cel in Window */ 
/* Cel AND Mask Bitmap */ 

/* Cel Bitmap */ 


j************************************************************************J 

/* Structure Definitions */ 

j************************************************************************j 

SPRITE helicopter; 

SPRITE bombs; 

SPRITE explosion; 

HBITMAP hBckgrdBitmap = (HBITMAP) NULL; 


f************************************************************************J 

/* Prototypes */ 

^************************************************************************j 


LONG FAR PASCAL WindowProc(HWND hWnd, UINT message, WPARAM wParam, LPARAM IParam); 
BOOL CreateSpritef HANDLE hlnst, HWND hWnd, LPSPRITE IpSprite, int x, int y, DWORD 
delay, ... ); 
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Try dragging such an icon across the 
desktop. Notice how it blends into the 
background? An icon is actually com¬ 
prised of two bitmaps: an “AND mask” 
and an “OR mask.” To draw an icon, 
Windows combines the “AND mask" — 
which looks like a silhouette — with the 


background, using a logical AND opera¬ 
tion, as shown in Figure 1. Since black 
maps to RGB(0,0,0) and white to 
RGB(255,255,255) in the Windows 
color palette, only silhouetted pixels af¬ 
fect the background. 


Listing 1 continued 


void DestroySprite( LPSPRITE IpSprite ); 

BOOL ShowSprite( HDC hDC, LPSPRITE IpSprite ); 

BOOL HideSprite( HDC hDC, LPSPRITE IpSprite ); 

^************************************************************************ j 

/* Program Begins */ 

j************************************************************************j 

int PASCAL WinMain(HINSTANCE hlnst, HINSTANCE hPrevInst, LPSTR lpCmdLine, 
int numCmdShow ) 

{ 

MSG msg; 

WNDCLASS wc; 

HWND hWnd; 

HDC hDC, hMemDC; 

RECT rect; 


wc.style 

wc.lpfnWndProc 

wc.cbClsExtra 

wc.cbWndExtra 

wc.hlnstance 

wc.hlcon 

wc.hCursor 

wc.hbrBackground 

wc.lpszMenuName 

wc.lpszClassName 


= (UINT) NULL; 

* WindowProc; 

- 0 ; 

= 0 ; 

= hlnst; 

= LoadIcon(NULL, IDI_APPLICATION); 
= LoadCursor(NULL, IDC_ARR0W); 

= GetStockObject(BLACKJRUSH); 

= (LPSTR) NULL; 

* “SpriteWndClass”; 


if (!RegisterClass(4wc)) 
return(FALSE); 


hWnd ■ GetDesktopWindow(); 
GetClientRect( hWnd, &rect ); 


hWnd = CreateWindow( "SpriteWndClass", "Sprites", 
WS_B0RD£R | WS_P0PUP, 

0, 0, rect.right, rect.bottom, 
NULL, NULL, hlnst, NULL ); 


if (ihWnd) 

return (FALSE); 

j******************************************************************** j 

/* Create Sprites */ 

^****************************************** ******************** ******j 

if (CreateSprite( hlnst, hWnd, &helicopter, rect.right, 0, 0, 
"HeloCell", "HeloMaskl", 

"HeloCel2", "HeloMask2", NULL ) == FALSE || 
CreateSprite( hlnst, hWnd, &bombs, 200, 0, 0, 

"BombCel", "BombMask", NULL ) == FALSE || 
CreateSprite( hlnst, hWnd, iexplosion, 0, 0, 150, 

"ExpCell", "ExpMaskl", 

"ExpCel2", "ExpMask2", 

"ExpCel3”, "ExpMask3“, 

"ExpCel4“, “ExpMask4“, 

"ExpCel5“, "ExpMask5", NULL ) == FALSE ) 

{ 

return(FALSE); 

) 

j********************************************************************j 

/* Capture & Display Screen */ 

j ********************************************************************j 
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Next, Windows combines the "OR mask” —which looks like 
a snapshot of the icon taken at night — with the background, 
using a logical OR operation. This time, the icon sticks to the 
pixels that were blackened by the silhouette. These AND-OR 
bitmaps are sometimes referred to as “cels." You can link 
together any number of cels to account for all possible ranges 
of motion for an actor or “sprite.” It would be rather con¬ 
venient to use icons as cels but, unfortunately, their maxi¬ 
mum resolution (32x32 pixels) is too confining. 

sprites.c (Listing 1) illustrates basic sprite animation. 
There are three sprites in this example — helicopter, bombs, 
and explosion — with varying numbers of cels. UinMainf) 
creates a borderless window equal in size to the desktop and 
calls CreateSprite(). The latter receives a variable parameter 
list containing the instance and window handles, cel resource 
names, frame positions, and delay times. CreateSpritef) allo¬ 
cates space with LocalAlloc(), loads the cels, and establishes 
a doubly-linked list to bind them together. UinMainf) copies 


the desktop into hBckgrdBitmap, fills the window with the 
desktop contents, and sets up a Windows timer to drive the 
animation sequence. 

Timer Operations 

Good timing is critical in both life and real-time animation. 
Windows treats the timer like any other peripheral device. PC 
timer tick interrupts occur approximately eighteen times per 
second, and Windows slices or "virtualizes" timer ticks between 
DOS and Windows virtual machines (VMs). VMs receive timer-tick 
interrupts only during active periods —not while suspended in the back¬ 
ground. 

Windows programs can take advantage of several SDK 
timing functions. One of these functions, SetTimerf), can 
either execute a callback procedure or cause UM_TIMER mes¬ 
sages to be sent at a specified interval (in milliseconds) to a 
window procedure. Its principal drawback is that, although 
UM_TIMER messages are (conceptually) placed in the application 


Figure 1 Windows Icon Drawing Technique 
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Listing 1 continued 


hDC * GetDC( hWnd ); 

hMemDC * CreateCompatibleDC( hDC ); 

hBckgrdBitmap * CreateCompatibleBitnap( hDC, rect.right, rect.bottom ); 
SelectObject( hMemDC, hBckgrdBitmap ); 

BitBlt( hMemDC, 0, 0, rect.right, rect.bottom, hDC, 0, 0, SRCCOPY ); 
DeleteDC( hMemDC ); 

ReleaseDC( hWnd, hDC ); 

ShowWindow( hWnd, numCmdShow }; 



SetTimer(hWnd, TIMER_ID, TIMER_RESOLUTION, (TIMERPROC) NULL); 

while (GetMessage(&msg, NULL, NULL, NULL)) /* Typical Message Loop */ 

{ 

TranslateMessage(&msg); 

DispatchMessage(&msg); 

} 

return (msg.wParam); 


/************************************************************************/ 

/* Window Procedure */ 

/★★★★★★★★★★★★★★★★★★★★★★★★★★★★Hr*******************************************/ 

LONG FAR PASCAL WindowProc(HWND hWnd, UINT message, WPARAM wParam, LPARAM IParam) 

{ 

PAINTSTRUCT paint; 

HDC hDC, hMemDC; 

HBITMAP hOldBitmap; 

static POINT dropPoint, impactPoint; 
static BOOL droppedBombs * FALSE; 
static RECT rect; 

switch (message) 

{ 

case WM_DESTROY: 

DestroySprite( Shelicopter ); 

DestroySprite( &bombs ); 

DestroySprite( Sexplosion ); 

DeleteObject( hBckgrdBitmap ); 

KillTimer( hWnd, TIMER_ID ); 

PostQuitMessage( NULL ); 
break; 

case WM_TIMER: 

hDC = GetDC( hWnd ); 

if (helicopter.lpCel->lpPrev->position.x > dropPoint.x) 

{ 

helicopter.1pCel->position.x = helicopter.lpCel->lpPrev->position.x - 10; 
helicopter.lpCel->position.y = helicopter.lpCel->lpPrev->position.y + 3; 

) 

else 

if (droppedBombs *■ FALSE) 

{ 

droppedBombs = TRUE; 

bombs.lpCel->position.x « helicopter.lpCel->lpPrev->position.x + 

(helicopter.lpCel->lpPrev->dimension.x / 3); 
bombs.lpCel->position.y = helicopter.lpCel->lpPrev->position.y + 
helicopter.lpCel->lpPrev->dimension.y; 
impactPoint.x = bombs.lpCel->position.x; 
impactPoint.y = (rect.bottom * 2) / 3; 

ShowSprite( hDC, &bombs ); 

) 

else 

if (bombs.lpCel->lpPrev->position.y < impactPoint.y ) 

{ 

bombs.1pCel->position.y = bombs.lpCel->lpPrev->position.y + 3; 
ShowSprite( hDC, &bombs ); 
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Listing 1 continued 


} 

else 

( 

explosion.lpCel->position = bombs.lpCel->lpPrev->positi on; 

HideSprite( hDC, &bombs ); 

ShowSprite( hDC, &explosion); 

} 

ShowSprite( hDC, &helicopter ); 

ReleaseDC( hWnd, hDC ); 
break; 

case WM_PAINT: 

GetClientRect( hWnd, &rect ); 

dropPoint.x = rect.right / 3; 

dropPoint.y = rect.bottom / 3; 

hDC = BeginPaint( hWnd, &paint ); 

hMemDC = CreateCompatibleDC( hDC ); 

hOldBitmap = SelectObject( hMemDC, hBckgrdBitmap ); 

BitBlt( hDC, 0, 0, rect.right, rect.bottom, hMemDC, 0, 0, SRCCOPY); 
SelectObject( hMemDC, hOldBitmap); 

DeleteDC( hMemDC ); 

EndPaint( hWnd, &paint ); 
break; 

case WM_LBUTT0ND0WN: 
case WM_RBUTT0ND0WN: 
case WM_MBUTTONDOWN: 
case WM_KEYDOWN: 
case WM_SYSKEYDOWN: 

SendMessage( hWnd, WM_CL0SE, (WPARAM) NULL, (LPARAM) NULL); 
default: 

return (DefWindowProc(hWnd, message, wParam, IParam)); 

) 

) 

^************************************************************************I 

/* Create Sprite */ 

j************************************************** **********************j 

BOOL CreateSprite( HANDLE hlnst, HWND hWnd, LPSPRITE IpSprite, int x, int y, 

DWORD delay, ... ) 

{ 

char *lpszCelName, ‘IpszMaskName; 

LPCEL IpPrev; 

LPCEL lpCel; 

BOOL retVal « FALSE, firstTime = TRUE; 

BITMAP bmlnfo; 
va_list marker; 

HOC hDC; 

memset( IpSprite, 0, sizeof(SPRITE)); /* Initialize Sprite Structure */ 

hDC = GetDC( hWnd ); 

va_start( marker, delay ); /* Setup stack frame for variable args */ 

while ((IpszCelName = va_arg( marker, char *)) && /* Read Mask Names */ 

(IpszMaskName « va_arg( marker, char *))) 

{ 

if ((lpCel = (LPCEL) LocalAlloc(LPTR, sizeof(CEL)))) /* Allocate CEL Memory */ 

' ( 

/* Load Mask Bitmaps */ 

if ((lpCel->hCelBitmap » LoadBitmap( hlnst, IpszCelName)) && 
(lpCel->hMaskBitmap = LoadBitmap( hlnst, IpszMaskName))) 

{ /* Get Mask Bitmap 

Dimensions */ 

GetObject( lpCel->hCelBitmap, sizeof( BITMAP ), (LPSTR) &bmInfo ); 

if (firstTime) 

{ 

firstTime » FALSE; 
lpSprite->lpCel = IpPrev * lpCel; 

lpSprite->delayTicks ■ delay; /* Establish Sprite Delay Time */ 


message queue, they are not accessible 
until other “cooperating” Windows 
programs relinquish control. Hence, 
WM_TIMER messages are not the most 
accurate timing mechanisms. Set- 
Timer() can degrade performance, too, 
since it requires Windows to manage 
additional window events. Like all other 
limited resources, timers must be 
released prior to program termination. 

Another timing function, GetTick- 
Count, lets you query the number of 
ticks (milliseconds) that have lapsed 
since the beginning of the Windows 
session. GetTickCount() works espe¬ 
cially well in situations where no Win¬ 
dows timers are available. Place Get- 
TickCountf) at the top of your mes¬ 
sage loop, and send UM_TIMER messages 
to your window procedure at ap¬ 
propriate times. Regardless of which 
technique you choose, remember to 
cooperate fully with other Windows ap¬ 
plications, and avoid the following situa¬ 
tion at all costs: 

while (GetTickCount() < TIMER_WAIT); 

The Sample Program 

sprites.c uses both SetTimer() and 
GetTickCount() for the animation se¬ 
quence. The window procedure 
receives UM_TIMER messages at a 
resolution of 50 milliseconds, or every 
l/20th of a second. While not quite 
matching the 24fps (frames per second) 
necessary for broadcast quality, this 
resolution produces acceptable anima¬ 
tion of small to medium objects. Upon 
receiving each WM_TIMER message, 
sprites.c uses GetTickCount() to 
determine whether individual sprites 
should be displayed or not, on the basis 
of their own internal frame delay. This 
makes it easier to run sprites at dif¬ 
ferent speeds. 

In this example, a helicopter swoops 
down from the upper right corner of 
the desktop, drops a load of bombs, 
and hovers over the resulting explosion, 
it looks easy enough, but actually defin¬ 
ing the behavior can get rather com¬ 
plex. You will notice that none of the 
sprites ever overlaps. Since the border 
around each sprite always exceeds its 
greatest range of horizontal or vertical 
motion, it isn't necessary to restore a 
previous cel before drawing the next 
Also, ShowSpritef) reduces unnecessary 
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screen output by performing inter¬ 
mediate BitBlt() SRCAND, SRCPAINT, 
and SRCCOPY operations to a temporary 
bitmap rather than the display itself. 
These considerations tend to minimize 
annoying screen flicker. 

Cautions and Adjustments 

Be careful about hardcoding sprite 
screen coordinates. To ensure that the 
animation sequence can run on both 
color and monochrome systems, 
retrieve the window dimensions with 
GetClientRect() before resorting to 
absolute coordinates. Be aware that 
sprites created in 1024x768 mode look 
downright gigantic in 640x480 mode. 
Device-independent bitmaps are 
preferable, too. One final point: even 
though there are only a few cels in this 
example, remember that you must 
deallocate resources when you’re 
finished with them —even if you're ter¬ 
minating your program. Windows can 
crash due to lost resources. 

Real-time animation performance is 
measured in terms of the average playback 
rate. An insufficient playback rate causes 
rough, jerky transitions between frames. It 


Listing 1 continued 


I 

else 

lpPrev->lpNext » lpCel; 


1pCel->lpPrev 
lpCel->lpNext 
lpCel->dimension.x 
lpCel->dimension.y 
lpCel->position.x 
lpCel->position.y 
IpPrev = lpCel; 

1pSprite->numCels++; 
retVal = TRUE; 
continue; 

I 

DestroySprite( IpSprite ); 

1 

retVal = FALSE; 

break; 

) 

va_end( marker ); 

ReleaseDC( hWnd, hDC ); 

return( retVal ); 


/* Starting Row Position */ 

/* Starting Column Position */ 
/* Save Ptr to Current Cel */ 
/* Increment Sprite Cel Count */ 


/* Couldn't Load Bitmaps */ 


/* Reset variable args */ 


■ IpPrev; 

* 1pSprite->lpCel; 

■ bmlnfo.bmWidth; /* Cel Width */ 

« bmlnfo.bmHeight; /* Cel Height */ 
- x; 

* y: 


j ★****★*★****★***★******★★*★*****★★*★*★★*****★★★★*★★★★★★★★*★★★★★*★*★★★★★★ i 

/* Destroy Sprite */ 

! ★★★**★*★****★★★★★*****★****★★*★****★*****★★********★★★**★★★*★*****★★**★★ j 


void DestroySprite( LPSPRITE IpSprite ) 

{ 

LPCEL lpCel, lpNext; 
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Listing 1 continued 


if ((lpCel = 1pSprite->1pCe1)) /* Is a Cel Allocated? */ 

{ 

do 

( 

if { lpCel->hCelBitmap ) /* Free Allocated Bitmap */ 

DeleteObject(1pCel->hCelBitmap); 

if ( lpCel->hMaskBitmap ) /* Free Allocated Bitmap */ 

DeleteObject(1pCel ->hMaskBitmap)j 

lpNext ■ lpCel->lpNext; /* Save Next Cel */ 

LocalFree( (HLOCAL) lpCel ); /* Free Current Cel */ 

) /* Loop to Next Cel */ 

while ((lpCel * lpNext) && lpCel != 1pSprite->lpCel); 

) 

memset( IpSprite, 0, sizeof(SPRITE) ); /* Reinitialize Sprite Structure */ 

return; 

) 

j************************************************************************J 

/* Show Sprite */ 

J*★**★★★★*★★***★*★*★★**★*★★**★*★★*★**★*★★**★★**★★*★***★*★★*★*★★★★*★★★★★★★j 


BOOL ShowSprite( HDC hDC, LPSPRITE IpSprite ) 

{ 

HDC hMemOC, hTempOC; 

HBITMAP hBitmap; 

LPCEL lpCel, IpPrev; 

DWORD currentTicks; 


currentTicks = GetTickCountQ; /* Read Stopwatch (mSecs) */ 

if ((currentTicks - 1pSprite->elapsedTicks) < lpSprite->delayTicks) 

return(FALSE); /* Has Sufficient Delay Passed? */ 

lpCel = 1pSprite->lpCel; 

IpPrev = lpCel->lpPrev; 

1 pSprite->lpCel = lpCel->lpNext; /* Point Sprite at Next Cel *7 

lpSprite->elap$edTicks « currentTicks; /* Reset Elapsed Time Counter */ 

hMemDC = CreateCompatibleDC( hDC ); 
hTempDC = CreateCompatibleDC( hDC ); 

hBitmap = CreateCompatibleBitmap( hDC, lpCel->dimension.x, lpCel -dimension.y ); 

SelectObject( hTempDC, hBckgrdBitmap ); /* hTempDC references the background */ 

SelectObject( hMemDC, hBitmap ); /* Begin Drawing New Cel on work hBitmap */ 

BitBlt( hMemDC, 0, 0, lpCel->dimension.x, lpCel->dimension.y, /* Copy background into */ 
hTempDC, lpCel->position.x, lpCel->position.y, SRCCOPY ); /* work hBitmap */ 

SelectObject( hTempDC, lpCel->hMaskBitmap ); 

BitBlt( hMemDC, 0, 0, lpCel->dimension.x, lpCel->dimension.y, 

hTempDC, 0, 0, SRCAND ); /* AND the Cel with work bitmap */ 

SelectObject( hTempDC, lpCel->hCelBitmap ); 

BitBlt( hMemDC, 0, 0, 1 pCel -dimension.x, lpCel->dimension.y, 

hTempDC, 0, 0, SRCPAINT ); /* OR the Mask with work bitmap */ 


BitBlt( hDC, lpCel->position.x, lpCel->position.y, /* Copy resulting work bitmap */ 
lpCel->dimension.x, lpCel -dimension.y, /* Directly to Display */ 

hMemDC, 0, 0, SRCCOPY ); 


1pCel->visible « TRUE; 
DeleteObject( hMemDC ); 
DeleteObject( hTempDC ); 
DeleteObject( hBitmap ); 
return(TRUE); 


/* Flag Cel as Visible */ 
/* Cleanup */ 

/* " */ 

/* " */ 
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Listing 1 continued 


/★A********************************************************************** j 

/* Hide Sprite */ 

^★★★★★★★*****************************************************************i 

BOOL HideSprite( HDC hDC, LPSPRITE IpSprite ) 

{ 

HDC hTempDC; 

LPCEL lpCel, IpPrev; 

BOOL retVal = FALSE; 

lpCel = lpSprite->lpCel; 

IpPrev = lpCel->lpPrev; 

if (lpPrev->visible =- TRUE) /* Only Hide if Visible */ 

< 

HTempDC = CreateCompatibleDC( hDC ); 

SelectObject( hTempDC, hBckgrdBitmap ); 

BitBlt( hDC, lpPrev->position.x, lpPrev->position.y, 
lpPrev->dimension.x, lpPrev->dimension.y, 
hTempDC, lpPrev->position.x, lpPrev->position.y, SRCCOPY ); 
lpPrev->visible * FALSE; 

DeleteObject( hTempDC ); 
retVal = TRUE; 

} 

return(retVal); 

) 

/* End of File */ 


is possible to increase performance by 
taking one or more of these actions: 
reduce the size and number of sprites, 
cut back on the number of cels, or hog 
the processor. Small bitmaps display 
faster than large ones and, as stated 
earlier in reference to timers, it isn't 
wise to hog the processor from com¬ 
peting applications. 
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Park, Chan S. Interactive Microcomputer 
Graphics. Reading, MA: Addison-Wes- 
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format or supply routines for reading and writing it. WinHelp lets the user print a 
single topic or copy it to a file via the clipboard (a doubly tedious process), but there 
is no facility for printing or copying a group of topics. 

I wanted to build a Windows help file with electronic versions of magazine ar¬ 
ticles, and I wanted the user to be able to press a single button to automatically 
copy into a directory all of the source files associated with the current article. Win¬ 
Help copies only a simple ASCII text version of a topic to the clipboard, so you lose 

most formatting information, such as different font 
sizes. However, since I just wanted to extract source 
code, WinHelp was up to the task. This article 
demonstrates how to automate for the user the task 
of extracting a group of help topics into ASCII text files. 
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Listing 1 DLL routines for automatic topic extraction 


linclude <stdio.h> 

#include <string.h> 

linclude <windows.h> 
linclude <commdlg.h> 
linclude <cderr.h> 

lif defined(_MSC_VER) 

linclude <direct.h> 

Idefine CHOIR chdir 

Idefine CHORIVE "chdrive 

Idefine GETCWD _getcwd 

lei if defined(_BORLANOC_) 
linclude <direct.h> 

Idefine CHOIR chdir 

Idefine CHORIVE chdrive 

Idefine GETCWD getcwd 

lendif 

Idefine MAXFILENAME 128 


UINT ClipInitFormat; 

HINSTANCE ModuleHandle; 

/* LibMain - store module handle, register clipboard format */ 

lifdef _BORLANDC_ 

Ipragma argsused 
lendif 

int CALLBACK LibMain(HINSTANCE ModuleHandle_, 

WORD DataSegment, WORD HeapSize, LPSTR CommandLine) 

{ 

if(HeapSize > 0) 

UnlockData(O); 

ModuleHandle - ModuleHandle_; 

ClipInitFormat - Register'd ipboardFormat("WinHelpKludge"); 
if(ClipInitFormat ■■ 0) 

{ 

MessageBox(NULL, 

"[wddjbest.dll]Can't register clipboard format.", 


NULL, MB_0K); 
return 0; 

} 

else 

return 1; 


/* WEP - return success */ 

int CALLBACK WEP(int ExitCode) 

{ 

return 1; 

} 

/* HookReturn - how to return value from cotrmon dialog */ 

static BOOL HookReturn(HWND Dialog, UINT Value) 

( 

return PostMessage(Dialog, WMCOMMAND, IDABORT, (LONG)Value); 

) 

/* DialogHook() - customize conmon dialog */ 

UINT CALLBACK export DialogHook(HWND Dialog, UINT Message, 

WPARAM WordParm, LPARAM LongParm) 

{ 

static char FAR "Buffer; 
switch(Message) 

{ 

case WMJNITDIALOG : 

{ 

OPENFILENAME FAR "FilePtr; 

FilePtr - (OPENFILENAME FAR *)LongParm; 

Buffer - (char FAR *)FilePtr->lCustData; 

/* disable File Name label */ 
EnableWindow(GetDlgItem(Dialog,1090), FALSE); 

/* disable File Name edit control */ 

EnableWindow(GetDlgItem(Dialog,1152), FALSE); 

I* disable File Name listbox */ 

EnableWindow(GetDlgItem(Dialog,1120), FALSE); /* listbox */ 
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WinHelp Macros 

A major feature of Windows 3.1 
WinHelp is its support for macros. Win- 
Help supplies a few dozen predefined 
macros that you can use to make your 
helpfile less of a passive information 
medium. You can invoke macros in any 
of several ways. 

• You can place macros in the [CON¬ 
FIG] section of your help compiler 
file and they will be invoked when 
winhelp.exe loads your help file. 

• You can attach macros to WinHelp 
menu items with the Chang Item- 
Bind ing() macro. 

• You can attach macros to WinHelp 
buttons with the ChangeButton- 
BindingO macro. 

• You can attach macros to a key¬ 
board combination with the Add- 
Accelerator() macro. 

• You can attach macros to hotspots 
(text or graphics) in the help file by 
entering, instead of a context string, 
an exclamation point followed by a 
macro string. 

• You can attach macros to seg- 
mented-graphics bitmaps with the 
hotspot editor (shed. exe). 

• Your application or DLL can call Nin- 
Help() With the HELP_COMMAND op¬ 
tion and pass it a macro string to ex¬ 
ecute. 

• You can specify a footnote macro by 
entering the macro string under the 
footnote character “I” at the begin¬ 
ning of a topic. Footnote macros are 
automatically invoked when the 
user jumps to the corresponding 
topic. 

In most of the places where you can 
enter a macro, you can also enter a 
string of macros separated by semi¬ 
colons. Arguably the most important 
WinHelp macro is RegisterRoutine(), 
since it lets you declare an external DLL 
routine that can then be used almost 
anyplace where one of the predefined 
macros can be called. The predefined 
macros are fairly limited in scope, so I 
knew I would need to augment my 
help file with a DLL of support routines 
that would be called from WinHelp’s 
macro facility, extract.c (Listing 1) con¬ 
tains the final version of the DLL support 


Listing 1 continued 


EnableWIndow{GetDlgItem(D1alog,1136), FALSE); 
return FALSE; 

) 

case HMJOMMAND ; 
swttchfwordPann) 

{ 

case IDOK ; 

( 

GetDlgltemText(Dialog, 1088, Buffer, MAXFILENAME-1); 
HookReturnfDialog, TRUE); 

) 

) 

return FALSE; 

) 

return FALSE; 

) 
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Listing 1 continued 


/* Beep() - a handy routine for debugging */ 

Cause ■ "buffor for filename was too small (1 pstrFI 1 e) " ; 
break; 

void WINAPI export Beep() 

case FNERR INVALIDFILENAME : 

{ 

Cause - "filename is invalid"; 

MessageBeep(O); 

break; 

} 

case FNERR_SUBCLASSFAILURE : 

Cause ■ "attempt to subclass listbox failed due 

1* SetPath() - Get desired directory from user */ 

to Insufficient memory"; 

break; 

static 

case 0: /* No error, just hit cancel button */ 

char CurD1r[MAXFILENAME]; 

return FALSE; 
default : 

Int WINAPI export SetPath() 

{ 

char HomeD1r[MAXFILENAME]; 

Cause ■ "unknown error"; 

\ 

i 

{ 

OPENFILENAME Fllelnfo; 

char Message [128]; 

OPENFILENAME FAR "FilelnfoPtr ■ AFilelnfo; 

wsprlntf(Message, "Common dialog error occurred because Vs.", Cause); 

char F11eName[MAXFILENAME]; 

MessageBox(NULL, Message, "Common Dialog Error", MB OK); 

Int Drive; 

1 

return FALSE; 

Drive ■ getdrive(); 

} 

HomeDir[0] - Drlve-l+'A* ; 

} 

HomeDir[l] - 

GETCWD(&HomeDir[2], MAXFILENAME-3) ; /* remember current dlr/drlve */ 


fstrcpy(CurD1r, ""); 

/* SetCaption() - Set caption of current help window */ 

fstrcpy(FileName, ""); 


fmemset(F11eInfoPtr, 0, slzeof(Filelnfo)); 

int WINAPI export SetCaption(unsigned long WindowHandle, 

Filelnfo.lStructSize ■ sizeof(Filelnfo); 

char FAR "Caption) 

Filelnfo.lCustData - (LPARAM)(char FAR *)CurOir; 

{ 

Filelnfo.lpstrFile ■ FileName; 

HWND Handle - (HWND)(WindowHandle&OxOFFFF) ; 

Fllelnfo.nMaxFile - MAXFILENAME-1; 


Filelnfo.lpfnHook ■ DlalogHook; 

Handle ■ GetParent(Handle) ; 

FIlelnfo.lpstrTItle ■ "Select Directory to Save to"; 

1f(Handle !- (HWND)NULL) 

Fllelnfo.IpstrFilter - "A11\0*.*\0\0"; 

{ 

Fllelnfo.Flags - OFN HIDEREADONLY 

SetW1ndowText(Handle, Caption); 

| OFN NOTESTFILECREATE 

return TRUE; 

| OFN ENABLEHOOK 

) 

j OFN PATHMUSTEXIST; 

else 

CHDRIVE(Drive); /* restore drive */ 

return FALSE; 

CHDIR(HomeDir+2); /* restore directory */ 

} 

if(GetOpenFi1eName(&Fi1elnfo)) 


return TRUE; 

else 

{ 

/* HelpYield() - clean clogged WinHelp message queues! */ 

static void HelpY1eld(B00L Clipboard) 

char "Cause; 

{ 

DWORD Error » CommDlgExtendedError(); 

MSG Message; 

switch(Error) 


{ 

wh11e(PeekMessage(&Message, NULL, 0, 0, PM REMOVE)) 

case CDERR FINDRESFAILURE : 

{ 

Cause - "could not find specified resource"; 

if(Message.message ■■ WM QUIT) 

break; 

( 

case CDERR INITIALIZATION : 

PostQuitMessage(O); 

Cause - "failed during Initialization, possibly out of memory"; 

return; 

break; 

} 

case CDERR LOADRESFAILURE : 

else 

Cause ■ "failed to load specified resource"; 

{ 

break; 

TranslateMessage(AMessage); 

case CDERR LOCKRESFAILURE : 

DispatchMessage(&Message); 

Cause ■ "failed to lock specified resource"; 

} 

break; 

if(Cl 1pboard && !IsClipboardFormatAvailable(ClipIn1tFormat)) 

case CDERR LOADSTRFAILURE : 

return; 

Cause ■ "load specified string"; 

} 

break; 

} 

case CDERR HEMALLOCFAILURE : 


Cause » "could not allocate memory for Internal structures"; 

/* 

break; 

* IsSecondary() - return true if in secondary help window. 

case CDERR MEMLOCKFAILURE : 

* 

Cause ■ "could not lock allocated memory"; 

* This function works by checking to see if the class name of the 

break; 

* enclosing window is "MS WINTOPIC SECONDARY". 

case CDERR NOHINSTANCE : 

*/ 

Cause - "found ENABLETEHPLATE flag, but no Instance handle"; 

Int WINAPI export IsSecondary(long WlnHandle) 

break; 

{ 

case CDERR NOHOOK ; 

char ClassName[128]; 

Cause ■ "found ENABLEHOOK flag, but no Kook function"; 

HWND HelpWindow - (HWND)LOWORD(WinHandle); 

break; 


case CDERR NOTEMPLATE : 

1f(HelpWindow I- NULL) 

Cause • "found ENABLETEHPLATE flag, but no template"; 

{ 

break; 

HelpWindow - GetParent(HelpWindow); 

case CDERR REGISTERMSGFAIL : 

if(HelpWindow !- (HWND)NULL) 

Cause ■ "received error from RegisterW1ndowMessage()"; 

if(GetClassName(HelpWindow, ClassName, 127)) 

break; 

1f(! fstrcmp(ClassName, "MS WINTOPIC SECONDARY")) 

case CDERR STRUCTSIZE : 

return TRUE; 

Cause ■ "received an invalid IStructSIze field"; 

} 

break; 

return FALSE; 

case CFERR NOFONTS ; 

) 

Cause - "no fonts exist"; 
break; 


case CFERR MAXLESSTHANMIN : 

/* 

Cause ■ "size in nSizeMax is less than nSizeMin"; 

* InitClipO - Clear clipboard to dummy format so we'll know when 

break; 

* valid data appears. 

case FNERR_BUFFERTOOSMALL : 

*/ 
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routines I created. You may want to 
refer to the listing while reading the fol¬ 
lowing discussion. 

A File Extract Button 

After studying the 3.1 SDK documen¬ 
tation. I thought I saw a way to create 
a “file extract” button. The CopyTopicf) 
macro copies the current topic to the 
clipboard. I decided to place in each 
source file topic a footnote macro that 
copied the topic to the clipboard, called 
a DLL function to copy the clipboard to 
a file, and then jumped to the next 
source file topic for the article. The 
source files belonging to a particular 
magazine article formed a kind of 
linked list — pressing the “Extract” but¬ 
ton would jump to the first one in the 
list, and the last one in the list would 
jump back to the main magazine article 
topic. Because a footnote macro gets in¬ 
voked every time you go to that topic, I 
had to use the IfThenf) macro so that 
the extracting would occur only if a 
mark called "Extract" was defined. The 
button macro created this mark before 
jumping to the first source file topic, 
and the last source file topic deleted it 


Listing 1 continued 


Int WINAPI export In1tC11p() 

{ 

HANDLE Success - NULL; 

HGLOBAL Durnny - GlobalA1loc(GHND, 1); 

If(Dummy !• (HGLOBAL)NULL) 

{ 

If(OpenClIpboard(NULL)) 

{ 

EmptyCl1pboard(); 

Success ■ SetC11pboardData(C11pIn1tFormat, Dummy); 
Closed ipboard(); 

} 

1f(Success ■■ NULL) 

Global Free(Dummy); 

) 

return Success I- NULL; 

) 

/* Extract() - copy clipboard to desired filename */ 

Int WINAPI export Extract(char FAR *F11eName) 

{ 

HelpYleld(FALSE); 

1f(IsCl1pboardFormatAvai1able(CF TEXT)) 

{ 

1f(OpenClipboard((HWND)NULL)) 

{ 

HANDLE MemoryHandle; 

MemoryHandle - GetClipboardData(CF_TEXT); 

if(MemoryHandle) 

( 

char FAR ‘FileData; 

FIleData - Global Lock(MemoryHandle); 

If(FileData) 

{ 

static char Name[128]; 

FILE ‘OutputFIle; 
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Listing 1 

continued 


{ 

char FAR *p - Name; 

while((*p++ - *FileName++) 1- '\0'); 

i 


OutputFile - fopen(Name, "w"); 


if(OutputFile 1- NULL) 


HelpYield(FALSE); 
while(*FileData) 

if(*File0ata -- '\r') 

++FileData; 

else if(*FileData — *\n') 

fputc('\n‘, OutputFile), ++FileData; 

else 

fputc(*FileData++, OutputFile); 
fclose(OutputFile); 

Hel pYi eld(FALSE); 


GlobalUnlock(MemoryHandle); 

} 

i 

CloseClipboardO; 

) 

} 

else 


MessageBeep(O); 

MessageBox(NULL, "Clipboard did not contain text!", 

"[wddjbest.dll]", MB_0K); 

return 0; 


) 

/* End of File */ 



This was the basic scheme, but the 
final version had some other niceties. 
First, I wanted the “Extract’’ button to 
be enabled only when a magazine ar¬ 
ticle (as opposed to some source code 
in a listing) appeared in the main win¬ 
dow. WinHelp supplies predefined 
macros for enabling and disabling help 
buttons, so all I had to do was place 
footnote macros in each topic that 
enabled or disabled the button, as ap¬ 
propriate. 

A more subtle problem was that, as 
WinHelp leapt from topic to topic after 
the “Extract" button was pressed, the 
user could not see that anything was 
happening. The WinHelp window went 
blank until all the files were extracted, 
then the original magazine article topic 
reappeared. I thought about putting up 
some kind of gas gauge, but I wanted 
to keep things simple. I opted for calling 
a "message pump" (which became 
necessary elsewhere in the code to 
work around a WinHelp bug) everytime 
my DLL routine got called to copy the 
clipboard to a file. By dispatching some 
messages for WinHelp, I allowed it time 
to actually paint the help window each 
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time it jumped to a new topic. Thus, the user could see in the 
help window the topics as they were being extracted. I 
decided this was a reasonable alternative to displaying a 
blank window. 

I used the common dialog routines to query the user for 
the destination directory. However, the common dialog may 
change the current drive or directory. If it does, and if WinHelp 
was able to locate the support DLL only because it was in the 
current directory, the result may be a "Routine not found” 
message the next time WinHelp calls a DLL support routine. To 
prevent this, 1 save the current directory and drive and restore 
them after calling the common dialog. 

One problem I did not deal with is multiple instances of 
WinHelp running the same help file. The DLL routines use 
static data to, for example, store the name of the destination 
directory for the extracted files, if two instances of WinHelp 
extracted files at the same time, one would overwrite the 
other’s directory name. This is not a common scenario, but it 
would be better to handle it. The problem is how to associate 
DLL data with a particular invocation of WinHelp. I have not 
found a solution I like, so I ignored the problem for now. 

WinHelp Does Not Synchronize 

The "linked list” scheme I just described almost worked, 
but had the most bizarre problem: the wrong topics were get¬ 
ting copied into the external files. In fact, things seemed to be 
off by one —the file for the first topic received the contents of 
the last topic, the file for the second topic received the con¬ 
tents of the first topic, and so on. By pure experimentation, I 
devised some equally bizarre 
workarounds that seemed to ac¬ 
complish the desired results, but I was 
very nervous about their reliability. 

Finally, I narrowed the problem down 
to a help file with a single footnote 
macro: 

CopyTopic();Extract("foo.c") 

By clearing the clipboard before running 
the help file, I determined that WinHelp 
was actually calling the DLL function 
(Extract ()) before it had copied the 
topic to the clipboardl This seemed im¬ 
possible, so I posted my problem in the 
WINSDK forum on CompuServe. Scott 
Skorupa of Microsoft support duplicated 
the problem and explained that it oc¬ 
curs because WinHelp executes some 
things asynchronously — it really was 
executing the second macro in the 
string before it had completed the first. 

Scott had run into this problem when 
he created a “Print All” facility in a Win¬ 
dows help file. In that case, however, 

WinHelp had at least produced an error 
message. Scott provided the 
workaround that I eventually used. The 
fix is to provide a DLL function that ini¬ 


tializes the clipboard to a junk value. The Extract () then 
begins by waiting in a loop (pumping messages through so 
WinHelp is not at a standstill) until the junk value disappears 
from the clipboard, then it knows that WinHelp has finally 
gotten around to executing the CopyTopicf) macro. The 
resulting required macro string looks like: 

InitClipO ;CopyTopic() ;Extract("foo.c") 

This is an ugly fix for an ugly bug in WinHelp. Scott's “Print All" 
button has to go to even furthur extremes — it depends on a 
loop that scans for a window with the title “Print Topic" to 
figure out whether the most recent Print () macro has 
finished executing. The real fix belongs in WinHelp. WinHelp 
should synchronize its asynchronous activities before calling 
any DLL routine or, at the very least, provide a macro the 
programmer can call to do this. Microsoft should also docu¬ 
ment WinHelp's behavior so that programmers know where 
asynchronous execution is likely to cause problems. 

The Rest of RegisterRoutine() 

The common dialog routines made it fairly easy to allow 
the user to select a destination directory after pressing the 
"Extract" button, but there was one problem: what if the user 
pressed the “Cancel” button instead of “Ok” after selecting a 
directory? How can a WinHelp macro test the return value of 
a DLL function? 

Once again, the crucial information was nowhere to be found 
in the 3.1 SDK documentation. The If Then () documentation 
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says only that it can test the result of an IsMark() or a 
Not(IsMarkO) expression. When I placed a DLL function call 
in an IfThenO macro, I got an error indicating a wrong 
parameter type. The RegisterRoutinef) SDK documentation 
showed how to declare the types of DLL routine parameters, 
but 1 searched in vain for the syntax for declaring DLL routine 
return types. 

The answer came again from Microsoft's CompuServe sup¬ 
port. Emily Brooks revealed that you can use any DLL function 
that returns an integral result in an IfThenO condition, and 
that the syntax for declaring return types is: 

<return>=<parml><parm2>... 


In other words, to declare a DLL routine that takes a far 
string pointer and returns an integer, you might write: 

RRC'my.dir, "foo", "i=S") 

As best as I could determine, the only place Microsoft has 
documented this syntax for declaring DLL routine return types 
is in an online help file supplied with the Professional version 
of Visual Basic. 

WinHelp Variables 

While experimenting with WinHelp macros, I got an error 
message along the lines of "invalid variable.” This piqued my 
interest; did that error mean there were valid WinHelp vari¬ 
ables one could use and pass as macro 
parameters? Emily Brooks replied that 
there are, and she supplied me with a 
page from the Microsoft Developer's 
Network CD-ROM describing them. You 
can't define your own variables, but 
you can use the predefined variables 
shown in Table 1. 

In my own help file, I wanted to dis¬ 
play source code topics in a secondary 
window so that the user could view 
source code while reading the 
magazine article. I thought it would be 
nice if the secondary window caption 
changed to contain the name of the file, 
but if the topic were displayed in the 
main window, I wanted the caption left 
alone. 

Since one of the predefined WinHelp 
variables provides the handle to the 
WinHelp window, I figured it would be 
easy to control the caption. Since Win¬ 
dows itself is just a DLL, you could 
declare and call Windows API routines 
directly, like this: 

RRC'USER", "SetWi ndowText", "v=uS") 
SetWindowText(hwndContext, "a capti on") 


This doesn't work, however, because 
WinHelp defines its window handles as 
32-bit quantities, but Windows 3.1 win¬ 
dow handles (such as the first 
parameter of SetUindowTextf)) are 16 
bits wide. As a result, you can't just 
pass hwndApp or hwndContext to a Win¬ 
dows API routine —you have to call a 
DLL routine that chops off the upper 16 
bits and passes the lower 16 bits to the 
Windows API routine for you. 

I view the 32-bit WinHelp handles as 
a misguided attempt to provide com¬ 
patibility with the Win32 API. Most Win¬ 
dows help files sophisticated enough to 
pass window handles around are going 
to be associated with DLLs that have to 
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be recompiled for Win32. It would have been much easier for 
programmers if WinHelp had just defined a handle type that 
was 16 bits in the Windows 3.1 version of WinHelp and 32 
bits in the Windows NT version of WinHelp. Then Windows 3.1 
help files could just call the Windows API directly. Also, other 
parts of WinHelp were not so scrupulous in avoiding 16-bit 
constructs, so the 32-bit handles under Windows 3.1 seem 
like a bit of a boondoggle. 

Even after I wrote my own SetCaption() DLL routine that 
used the lower 16 bits of hwndContext to call SetUindow- 
Text(), it didn't work. After exploring a bit with the De- 
Mystifiers tools, I found that the window hwndContext refers 


to is a child of the window that contains the caption. Once I 
changed my code to pass the parent of hwndContext to Set- 
UindowText(), it worked fine. 

While I was poking around with DeMystifiers, I noted that 
the window class name WinHelp uses for secondary windows 
lftS_UINTOPIC_SECONDARY) is different than that for main win¬ 
dows flS_WINTOPIC). This provided the information I needed to 
create an IsSecondaryO function that returns TRUE for 
secondary windows and FALSE for main windows. This can be 
useful in other contexts, since many of the predefined macros 
come with the vague warning “Use of the macro in secondary 
windows is not recommended.” 


Undocumented WinHelp 


WinHelp gained many new features in Windows 
3.1, and Microsoft's Windows 3.1 SDK contains many 
pages of documentation for WinHelp. Still, it was not 
possible to write the code in this article based solely 
on the documentation Microsoft supplied in the SDK. In 
fact, the winhelp.exe you acquired with Windows 3.1 
has many very useful features that Microsoft's SDK 
documentation does not mention at all! 

Would you like to place a child window inside a 
help topic and be able to update it dynamically at run¬ 
time? You can. Would you like to have WinHelp notify 
your DLL of various useful events, such as startup, ter¬ 
mination, and jumping to new help topics? You can. 
Would you like to access the internal file system Win¬ 
Help maintains in each .hip file, accessing both exist¬ 
ing topics and completely unrelated files that you 
added to the help file at compile time? You can. 

Actually, Microsoft can do these things, but you 
can't, because you don't have the necessary documen¬ 
tation. So how do I know these features exist? 
Microsoft is slowly leaking information about these 
WinHelp features, but in odd places where most 
developers won't think to look. Three places I have 
heard of are: the Microsoft Developer's Network (MSDN) 
pre-release CD-ROM, the Professional version of Visual 
Basic v2.0, and the Multimedia Viewer documentation. 
The cheapest option (if you can beg, borrow, or steal a 
CD-ROM drive) is the MSDN CD-ROM, at $30 (call 
(800)227-4679x11771 and have your credit card ready). 
Look for the “Help Authoring Guide” on the CD-ROM. 

Before you plop down your hard-earned cash for a 
CD-ROM, I have to warn you that you still won't get 
enough documentation to use most of the new fea¬ 
tures. You will be able to use embedded windows (you 
can get the information you need to do that by 
downloading embww.zip from library 16 of the WINSDK 
forum on CompuServe). You won’t be able to use 
WinHelp’s DLL notification messages or access the 


many internal WinHelp file system functions, though. 
The reason is that the documentation depends on 
sample files that were omitted from the CD-ROM. 
These files supply the values for the symbolic con¬ 
stants you need to use the new functions, so you can't 
do much without them. I contacted Microsoft's 
Developer Network and they acknowledged that the 
files are missing and promised to find them and upload 
them to the MSDN forum on CompuServe. As we go to 
press, they have not yet located the missing files. 

WinHelp is a frustrating example of the ever-chang¬ 
ing line between documented and undocumented 
Windows functionality. There is no question that 
Microsoft put many nontrivial features into the Win¬ 
dows 3.1 version of WinHelp that it did not document 
in the Windows 3.1 SDK. The claim that Microsoft 
employees gain no competitive advantage from such 
cases of incomplete documentation is untenable. Poor, 
incorrect, and incomplete documentation serves 
neither the best interests of independent software 
vendors nor, in the long run, of Microsoft. 

Microsoft also does a disservice by distributing the 
missing documentation in dribs and drabs, scattered 
here and there across its many product and service 
groups. Programmers who paid for a Microsoft Win¬ 
dows 3.1 SDK have every right to expect complete 
documentation, without having to pay for additional 
services or products. Microsoft should produce com¬ 
plete, correct documentation for WinHelp and dis¬ 
tribute it freely and widely, as soon as possible. 
Microsoft should also either document the .hip file for¬ 
mat, or supply a library of routines for reading and 
writing them so that third-party vendors can fill the 
many gaps left by the anemic Microsoft suite of Win¬ 
dows help file programming tools. The result would be 
less wasted time for programmers and better online 
help for users. □ 
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Summary 

By combining the Windows 3.1 ver¬ 
sion of WinHelp with your own DLL 
routines, you can produce many in¬ 
novative effects in your Windows help 
files. Figure 1 shows my help file in ac¬ 
tion, with the “Extract” button for auto¬ 
matically extracting source code files. 
The extra effort you put into your on¬ 
line help will be appreciated by users 
for the lifetime of your application. □ 
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Table 1 Predefined WinHelp Variables 

hwndApp 

hwndContext 

These are handles to, respectively, the main help window and 
the current help window (which could be either the main 
window or a secondary window defined at compile time). They 
are defined as “U" variables (32-bit), so use a DLL routine to 
remove the upper 16 bits before passing them to any Windows 

3.x API function. 

coForeground 

coBackground 

Respectively, the current foreground color and current 
background color of the help window. These are 32-bit “U” 
variables containing RGB colors. 

qchPath 

A far string (“S" variable) pointing to the complete path of the 
help file (e.g, “C:\app\app.hlp”). Useful in predefined macros that 
require you to specify the name of the help file. 

qError 

An “S” variable, but really a pointer to a structure that describes 
the most recent WinHelp error. 1 am still tracking down 
complete documentation on this structure. 

ITopicNo 

A “U" (32-bit) variable containing the sequential number of the 
current topic, based on the order in which the topics were 
compiled. Unless you use the topic number as the context 
number of each topic (which is often not convenient), this is 
fairly useless. 

hfs 

A 32-bit ("U”) variable that is a handle to WinHelp's internal file 
system in your .hip file. You can call internal WinHelp functions 
with this handle to perform I/O to the internal file system. Some 
crucial parts of the documentation have not been released yet, 
however. 


Figure 1 77ie help file in action 
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Dialog Boxes on the Fly 


John Caulfield 


For many Windows applications, the first step in the development process (and 
sometimes the only step) is designing a dialog box. In fact, among the Windows 
interface elements, only the menu is more ubiquitous. 

A Windows dialog box is normally defined in a resource script or laid out with a 
dialog editor. However it's defined, the dialog box is compiled to a dialog template 
which is bound to your executable file as a resource. The resource can then be 
addressed by either name or integer ID. 

For most uses of dialog boxes, this system works. It gives the programmer or 
designer maximum freedom to choose design tools and methodologies while provid¬ 
ing a consistent interface to the application code. In certain situations, however, the 
programmer cannot design a dialog box at compile time. A database system, for 
example, must give its users the ability to create customized dialogs for data input 
Moreover, because dialog resources are part of the executable file, frequent dialog 
revisions may complicate the version control process. It may even become necessary 
to distribute a new executable version in which essentially only the dialog template 
is changed. 

I encountered a variant of both of these dilemmas while designing an application 
to provide input formatting and validation for messages for a 3270 communications 
system to be used by work groups in several cities. The requirements of the applica¬ 
tion were few and undemanding: 

• The user had to be able to open an input format on screen for any of several 
types of messages and enter information. 

• When the user indicated the message was complete, fields had to be checked for 
valid contents. 

• If everything was okay, the message would be sent. 

Nothing could be simpler. It was obvious that I could use modeless dialog boxes 
for the message formats and avoid a lot of grunt work while providing the users 
with a familiar interface. I anticipated having the application up and running in short 
order. 


John Caulfield works for a large financial services company, where he programs 
primarily to bridge the gap between mainframe systems and PCs. His programming 
interests range from microcontrollers to UNIX systems. He can be reached via Compu¬ 
Serve at- 71450,427. 
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A problem became apparent, however, when I began 
cataloging the required message formats. For certain esoteric 
but necessary reasons, the messages that the Chicago group 
used contained a field that no one else needed. Philadelphia's 


formats were consistent with New York's —except that “Can¬ 
cel Order" messages used alphabetic rather than numeric 
order references. Certain messages used in those locations 
weren’t needed at all in San Francisco. And so on. Minor 


Listing 1 bldtmp.c 


/* bldtmp.c */ 

linclude <str1ng.h> 
#define STRICT 
Idefine WINVER 0x3000 
#include <windows.h> 
linclude "dyndlg.h" 


typedef struct! 

long dtStyle; 

BYTE dtltemCount; 

Int dtX; 
int dtY; 
int dtCX; 
int dtCY; 

) DlgTemplateHeader; 

typedef struct! 

int dtilX; 
int dtilY; 
int dtilCX; 
int dtilCY; 
int dtillD; 
long dtilStyle; 
}DlgItemTemplateHeader; 
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// Creates a dialog template. Returns 
// NULL on failure. 

GL0BALHANDLE NewDlgTemplate(DWORD Style,WORD X.WORD Y, 
WORD CX.WORD CY.LPSTR Menu.LPSTR Class, 
LPSTR Text.LPSTR TypeFace.WORD PtSize) 

( 

DlgTemplateHeader far * lpOT; 

LPSTR lpsztemp; 

GLOBALHANDLE hDTemplate; 
long needed_size; 

needed_size*sizeof(DlgTemplateHeader)* 
lstrlen(Menu)+l+lstrlen(Class)+l+lstr1en(Text)+l; 

if(TypeFace[0]) 

needed_size+-lstrlen(TypeFace)+l+sizeof(short); 


hDTemplate=GlobalA1loc(GMEM_MOVEABLE | GMEM_ZEROINIT, 

needed_size); 

if(hDTemplate==NULL) 
return hDTemplate; 

1pDT-GlobalLoc k(hDTemplate); 

lpDT->dtStyle=WS_VISIBLE | Style; 

lpDT->dtX-X; 

lpDT->dtY*Y; 

lpDT->dtCX=CX; 

lpDT->dtCY*CY; 

// here's where we copy in the variable length 
// elements 

1psztemp=((LPSTR)lpDT)+sizeof(*lpDT); 

1psztemp=_fmemccpy(lpsztemp,Menu,0,MAX_STRING+1); 
lpsztemp=_fmemccpy(lpsztemp,Cl ass,0,MAX_STRING+1); 
lpsztemp=_fmemccpy(lpsztemp,Text,0,MAX_STRING+1); 

// if a Font was specified, build Fontlnfo 
if(TypeFace[0]) 

( 

‘((short far *)lpsztemp)=PtSize; 
_fmemccpy(lpsztemp+sizeof(short),TypeFace,0, 

MAX_STRING+1); 

1pDT->dtStyle|=DS_SETFONT; 

) 

GlobalUnlock(hDTemplate); 
return hDTemplate ; 

) 


// Adds a control to a dialog template. Returns 
// FALSE if allocation fails. 

BOOL 

AddDlgItem(GLOBALHANDLE DlgTmp,DWORD Style,WORD X, 
WORD Y.WORD CX.WORD CY, 
LPSTR Class,LPSTR Text, 
BYTE DataLen,LPSTR Data, 
BYTE Type) 

( 

DlgTemplateHeader far * lpDT; 
DlgltemTemplateHeader far ‘IpDIT; 
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inconsistencies between the formats sprang up like weeds. I 
knew as well that these message formats were likely to be 
changed at unpredictable times, and that I would be seeing 
frequent requests for new dialogs on short notice. 


I didn't relish the idea of maintaining a different version of 
the application for each site. Nor did I want to distribute one 
executable which contained the dialogs for all locations and 
required the user to select the correct set. A better solution 


Listing 1 continued 


LPSTR lpsztemp; 

GLOBALHANDLE hDTemplate; 
unsigned new_size,BlockSize; 

BlockSize=TemplateSize(DlgTmp); 

new_size=BlockSize+sizeof(DlgltemTempI ateHeader)+ 
lstrlen(Class)+l+lstrlen(Text)+l+l; 

// if DataLen is non-zero, reserve space for Oata 
if(DataLen) 

new size+=DataLen; 


hDTemplate=GlobalReAlloc(DlgTmp,new_size, 

GMEM2ER0INITI GMEM_MOVEABLE); 

if(hDTemplate'=NULL) 
return FALSE; 


1pDT=GlobalLock(hDTempl ate); 

1pDIT=(DlgltemTemplateHeader far*)(((LPSTR) 1 pDT)+BlockSize); 

lpDIT->dtilX=X; 

lpDIT->dtilY'Y; 

1pDIT->dtilCX=min(CX, 1 pDT->dtCX); 

1pDIT->dti1CY=min (CY,1pDT->dtCY); 

// Control ID combines index and 
// Field type so DialogProc 
// will know how to handle control 
lpDIT->dtilID=lpDT->dtItemCount | (Type«8); 

1pDIT->dti1Style=WS_VISIBLE | WS_CHILD | Style; 
lpsztemp=(char far*)(lpDIT)+sizeof(*lpDIT); 
lpsztemp=_fmemccpy(lpsztemp,Class,0,MAX_STRING+l); 
lpsztemp=_fmemccpy(lpsztemp,Text,0,MAX_STRING+l); 
if(DataLen) 

_fmemcpy(lpsztemp,Data,DataLen); 
lpDT->dtItemCount++; 

G1obalUniock(hDTemplate); 
return TRUE; 


// Scans a dialog box template and returns 
// its length 

int TempiateSize(GLOBALHANDLE hDlgTmp) 

{ 

DlgTemplateHeader far * lpDT; 

// DlgltemTempIateHeader far *1pDIT; 

LPSTR lpstr.lpbase; 
int isize; 
int i; 

// first scan the DLGTEMPLATE 

lpDT=(DlgTemplateHeader far *)G1obalLock(hDlgTmp); 

1 pbase=(LPSTR)1pDT; 
lpstr=(LPSTR)(lpDT+1); 
isize=sizeof(*lpDT); 

lpstr=lpbase+(isize+=(lstrlen(lpstr)+l));// Menu[] 
lpstr=lpbase+(isize+=(lstrlen(lpstr)+l));// Class[] 
lpstr=lpbase+(isize+=(lstrlen(lpstr)+l));// Caption[] 


// if necessary, the FONTINFO 
if((1pDT->dtStyle)&DS_SETFONT) 

( 

isize+*sizeof(short); 
lpstr+=sizeof(short); 
lpstr*lpbase+(isize+*(lstrlen(lpstr)+l)); 

) 

// finally, each of the DLGITEMTEMPLATEs 
for(i=0;i<lpDT->dtItemCount;i++) 

{ 

1 pstr=l pbase+(i si ze+=si zeof(DlgltemTempIateHeader)); 
lpstr-lpbase+(isize+=(lstrlen(lpstr)+l));// 

Cl ass [] 

lpstr=lpbase+(isize+=(lstrlen(lpstr)+l));// Text[] 
if(*lpstr) // i.e. if DataLen is non zero 
{ 

isize+=*lpstr; 

lpstr+=*lpstr; 

) 

isize++; 

} 

GlobalUnlock(hDlgTmp); 
return isize; 

} 

/* End of File */ 
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would be to maintain one executable and distribute only the 
message formats to the appropriate sites. Ideally, the formats 
could be stored in text files so that changes could be made 
on site, if necessary. However, a dialog box designed in the 
usual way is too tightly bound to the executable file for this 
type of solution, not only physically but logically as well. The 
physical binding is obvious — it's actually stored in the same 
file. The logical coupling is perhaps more important. 

A normal DialogProc, on receiving a UM_COMMAND message, 
uses wParam — that is, the ID of the menu, control, or ac¬ 
celerator which generated the message — to determine its ac¬ 
tions. But writing this code requires that you know the IDs of 
your controls when you write the dialog procedure. This is a 
luxury I couldn’t have if my users were to be able to design 
or alter the dialogs after the executable was out of my hands. 


So I had two questions to answer — how do you define a 
dialog box at runtime, and how do you do anything with it 
after you have defined it? 

The Dialog Template 

Ordinarily, you use the CreateDialogf) function when you 
open a modeless dialog box from a resource. CreateDialog- 
Indi rect() serves the same function when you need to cre¬ 
ate one dynamically. The functions are identical in use except 
for the value of their second arguments: 

HWND CreateDialog(HANDLE hlnstance, 

LPSTR lpTemplateName, HANDLE hWndParent, 

FARPROC lpDialogFunc) 

HWND CreateDialogIndirect(HANDLE hlnstance, 

LPSTR lpDialogTemplate, HANDLE hWndParent, 

FARPROC lpDialogFunc) 


Listing 2 intrprtr.c 


/* Intrprtr.c */ 

♦define STRICT 
♦define WINVER 0x3000 
♦include <windows.h> 
♦include <stdio.h> 
♦include <string.h> 
♦include "dyndlg.h" 
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// accepts a filename and reads a definition into 
// a DialogTemplate. Returns handle or NULL on error 
GLOBALHANDLE ReadDialog0ef(char ‘filename) 

( 

int i=0; 

WORD wX,wY,wCX,wCY,wItemCount,wFieldType, 
wPosition.wLength; 

char strl[MAX_STRING+1],str2[MAX_STRING‘l]; 
char buffer[200]; 

GLOBALHANDLE hlnfo-NULL; 

Dlglnfo far* lpInfo-NULL; 

FILE ‘file; 
long IStyle; 

do 

I 

if(NULL--(fi1e=fopen(fi 1 ename,"r"))) 
break; 

fgets(buffer,199,fi 1 e); 

if(8!=sscanf(buffer,"%7s%80s%d%d%d%d%d%d",strl, 
Str2,&wX,&wY,&wCX,&wCY, 
&wLength,&wItemCount)) 

break; 


if(NULL—(hlnfo-GlobalAlloc(GMEM MOVEABLE | 

GMEM_ZER0INIT, sizeof(DlgInfo)+ 
((wItemCount-l)*sizeof(01gItemInfo))))) 

break; 

IpInfo-GlobalLock(hlnfo); 

if(_fstrcmp(strl,"DIALOG")) 
break; 

if(!strcmp(str2,"\ u \"")) 
str2[0]=0; 

1Style=WS_SYSMENU | WS_CAPTI0N | WSVISIBLE | WS_0VERLAPPED; 
1pInfo->diRecSize-wLength; 

if(NULL—(lpInfo->dihDlgTmp=NewDlgTemplate(1Style.wX.wY, 
wCX,wCYstr20))) 


break; 


for(i-0;i<wItemCount;i++) 

I 

if(NULL==fgets(buffer.200.fi le)) 
break; 

if(8!-sscanf(buffer,"%80s%80s%d%d%d%d%d%d".strl. 
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Where CreateDialogO takes a far pointer to the name of a 
dialog box template, CreateDialoglndirect() accepts a far 
pointer to the template itself. So to open a modeless dialog 
box at runtime, all you need to do is initialize a template 
defining it, call CreateDialogIndirect(), and you’re off and 
running. 

It's a little more work than it sounds. The dialog box 
template is a complex object It is actually a concatenation of 
three structures packed tightly in memory. One of them is 
optional and one may be repeated up to 255 times. Each of 
these structures contains variable length members, so initializ¬ 
ing them is not a simple matter of assigning values to 
str. member. 

The template always begins with the following: 

(continued on page 30) 


Listing 2 continued 


str2,&wX,&wY,&wCX,&wCY t &wLength,&wPosition)) 

{ 

i—; 

continue; 

} 

if(!strcmp(str2,“\"\ n ")) 

str2[0]-0; 

wFieldType=Lookup(strl,TypeNames); 
if(wFieldType>TYPE NAME COUNT-1) 

{ 

1 —; 

continue; 

) 

lStyle=FieldStyles[wFieldType]; 
if(!AddDlgItem(lpInfo->di'hDlgTmp,lStyle,wX,wY, 
wCX,wCY,ClassNames[wFieldType], 
str2,0,NULL,wFieldType)) 

i 

i—; 

continue; 

) 

lpInfo->diItems[i].diiLength=wlength; 
lpInfo->diItems[i].diiPosition=wPosition; 

1 

} 

while(O); 

if(file) 

fclose(file); 

if(hlnfo) 

GlobalUnlock(hlnfo); 
return hlnfo; 

} 

// finds match for string in table or 

// returns index or -1 on failure 

int Lookup(char far *key,char far *table[]) 

( 

int i; 

for(i=0;table[i]!=NULL;i++) 

( 

if(!_fstrcmp(key,table[i])) 
return i; 

) 

return -1; 

} 

/* End of File */ 
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Listing 3 dyndlg.c 


/♦dyndlg.c*/ 

finclude <math.h> 
finclude <stdlib.h> 
linclude <string.h> 
linclude <stdio.h> 
#include <ma11oc.h> 
#include <ctype.h> 

#define STRICT 
#define WINVER 0x3000 
linclude <windows.h> 

Idefine DEFINE_GLOBALS 
linclude "dyndlg.h" 


HWND hMainWnd; 

HINSTANCE hlnstanceGlobal; 
HWND hDlgBox[DLG COUNT]; 
DLGPROC lpDlgProc=NULL; 
WNDENUMPROC 1pEnterProc=NULL; 
DLGPROC lpFOpnProc=NULL; 


int PASCAL WinMain(HINSTANCE hlnstance, 

HINSTANCE hPrevInstance,LPSTR lpCmdLine.int nCmdShow) 

{ 

MSG msg; 

int i.wTextExtent; 

WNDCLASS wndclass; 

char szCl assName[]=”DYNDLG“; 

HDC hOC; 

hInstanceGlobal=hInstance; 

if(lhPrevInstance) 

{ 

wndclass.style =0; 

wndclass.1pfnWndProc =(WNDPROC)WndProc; 

wndclass.cbClsExtra =0; 

wndclass.cbWndExtra =0; 

wndclass.hlnstance 'hlnstance; 

wndclass.hlcon =LoadIcon(NULL,IDI_APPLICATION); 

wndclass.hCursor =LoadCursor(NULL,IDC_ARROW); 

wndclass.hbrBackground'GetStockObject(WHITE_BRUSH); 
wndcl ass.1pszMenuName =szClassName; 
wndcl ass. 1 pszClassName-szClassName; 
if (! Register'd ass (&wndcl ass)) 
exit(l); 

} 

hDC=GetDC(GetDesktopWindow()); 

wTextExtent=LOWORD(GetTextExtent(hDC,WINDOW_NAME,strlen(WINDOW_NAME)))* 5/3; 
ReleaseDC(GetDesktopWindow(),hDC); 

hMainWnd'CreateWindow( szClassName, 

WINDOWJAME, WS_OVERLAPPED| WS_SYSMENU, 

CW USEDEFAULT,CW_USEDEFAULT, 

wTextExtent + GetSystemMetrics(SM_CYCAPTION), 

GetSystemMetrics{SM_CYCAPTION)+ 

GetSystemMetrics(SM CYMENU)+ 

2*GetSystemMetrics(SM_CYBORDER), 

NULL,NULL,hlnstance,0 ); 

if(!hMainWnd ) 
exit( 2 ); 

ShowWindow(hMainWnd,nCmdShow); 

lpEnterProc'(WNDENUMPROC)MakeProcInstance((FARPROC)EnterProc,hlnstanceGlobal); 


typedef struct { 
long dtStyle; 

BYTE dtltemCount; 
int dtX; 
int dtY; 
int dtCX; 
int dtCY; 
char dtMenuName[]; 
char dtClassName[]; 
char dtCaptionText[]; 

} DLGTEMPLATE; 

The first six members are straightfor¬ 
ward. dtStyle specifies the dialog box 
style and accepts the same set of 
values as the STYLE statement in a 
resource script — that is, it’s a logical OR 
of window style and dialog style values. 
dtX, dtY, dtCX, and dtCY specify the 
dialog box’s x-position, y-position, 
width, and height. Like the correspond¬ 
ing fields in a resource script DIALOG 
statement, dtX and dtCX use units 
equal to 1/4 the dialog base width unit. 
Similarly, dtY and dtCY express y 
values in units equal to 1/8 the dialog 
base height unit. dtltemCount indicates 
the number of controls contained in the 
dialog box. 

The typedef above is taken from the 
Windows 3.0 Programmer’s Reference 
and is for information only: don’t try to 
compile it. Arrays of char with empty 
square brackets can’t be members of a 
real struct since the compiler doesn’t 
know their size. dtMenuNamef], dt- 
ClassNamef], and dtCaptionText[] 
each represent a string terminated with 
a single null byte. If any of these mem¬ 
bers is an empty string, its null byte still 
appears. These are not pointers to 
strings; rather, the strings themselves 
succeed the last fixed-size element, 
dtCY, in memory. The contents of these 
strings correspond to the arguments in 
the MENU, CLASS, and CAPTION resource 
script statements. 

The next piece of the template is 
optional. If the dialog box uses a font 
other than the default system font, this 
structure must immediately succeed 
the terminating null of dtCaptionText: 

typedef struct{ 
short int PointSize; 
char szTypeFace[]; 

} F0NTINF0; 
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The szTypeFace field contains the name 
of a typeface. PointSize specifies the 
requested size of the font. The font 
must have been previously loaded 
either in the FONTS section of win. ini 
or by LoadFont(). If a FONT INFO is 
present in the template, the dtStyle 
field above must have the DS_SETFONT 
style set. 

Following the terminating null of sz¬ 
TypeFace, if present, or else of dt- 
CaptionText is a structure defining the 


} DLGITEMTEMPLATE 

One of these follows, tightly packed, for 
each subsequent control in the dialog 
box. 

You define a control with this struc¬ 
ture using the same values you would 
to specify a user-defined control in a 
resource script. dtilX, dtilY, dtilCX, 
dtilCY, dtillD, dtilText[], and dtil- 
Class[] correspond to the x, y, width, 
height, ID, text, and class parameters of 
the CONTROL statement 

You can create any of the common 
dialog box controls this way, although 
the combination of class and style re¬ 
quired is not always obvious. For ex¬ 
ample, a GROUPBOX control uses the 
BUTTON class with style BS_GROUPBOX (I 
recommend examining Table 8.2, "Con¬ 
trol Classes,” and Table 8.3, “Control 
Styles," in the Programmer’s Reference). 
You are not restricted to Microsoft's 
predefined control classes; your own 
custom controls or third-party products 
such as Borland’s “BorDIg...” controls can 
be used here as well. 

The dtillnfo field indicates the 
length of the remaining member, dtil- 
Data. If dtillnfo is zero, dtilData is 
not present. Unlike the other variable 
length fields in this and the preceding 
structures, which are strings terminated 
by null bytes, dtilData can contain any 


first of the controls: 

typedef struct { 

int 

dtilX; 

int 

dtilY; 

int 

dtilCX; 

int 

dtilCY; 

int 

dtillD; 

long 

dtilStyle; 

char 

dti 1 Cl ass []; 

char 

dti 1 Text []; 

BYTE 

dtillnfo; 

PTR 

dtilData; 


Listing 3 continued 


lpDlgProc*(DLGPR0C)MakeProcInstance((FARPR0C)D1alogProc,hInstanceGlobal); 
lpFOpnProc«(DLGPROC)MakeProcInstance((FARPROC)FOpenProc,hInstanceGlobal); 


whi1e( GetMessage( &msg, NULL, 0, 0 } ) 


( 


for(1-0;1<DLG_C0UNT;1++) 

{ 

1 f (! hDl gBox [i ]) 
continue; 

else 

if(IsDialogMessage(hDlgBox[1],&msg)) 
break; 

) 

1f(i— DLG COUNT) 

{ 

TranslateMessage( &msg ); 
DispatchMessage( »msg ); 


FreeProcInstance((FARPROC)lpEnterProc); 
FreeProcInstance((FARPROC)lpDlgProc); 
FreeProcInstance((FARPROC)lpFOpnProc); 


return msg.wParam; 


// CallBack for dynamic dialogs 

BOOL FAR PASCAL DialogProc(HWND hOlg.UINT Msg, 

WPARAM wParam,LPARAM IParam) 


{ 


int i,j; 

char buffer[MAX_STRING+l]; 

switch(Msg) 

( 

case WMJN1TDIAL0G: 

return TRUE; 
case WM COMMAND; 

{ 

switch(HIBYTE(wParam)) 

I 

case TYPE NUMERIC: 


1f(HIWORD(1Param)**EN JCILLFOCUS) 

( 

if(GetParent(G«tFocus())«*hDlg) 


f 


j=GetWi ndowText((HWND) L0W0RD(1 Param),buffer,MAXJTRI NG); 
for(i=0;i<j;i++) 

{ 

if(I1sdigit(buffer[i])) 
break; 

) 

if(Kj) 

( 

MessageBox((l*fllD)L0W0fffi(l Param) ."Must Be Nimeric!",NULL,MB_OK); 
SetFocus((HWND)LOWORD(lParam)); 


) 

return TRUE; 

) 

case TYPE_ENTERBUTTON: 

{ 

SendMessage(hMainWnd.DYNMJNTER, (WPARAM) hDlg,0); 
return TRUE; 

) 

default: 
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Listing 3 continued 


return FALSE; 

} 

} 

case WM_SYSCOMMAND: 

{ 

1f(wPararo--SC CLOSE) 

{ 

SendMessage(hMalnWnd,DYNM_CLOSE,(WPARAM)hDlg,0); 
return TRUE; 

) 

return FALSE; 

} 

case WM_DESTROY: 

( 

Global Free(RemoveProp(hDlg,PROP_DLGINFO)); 
return FALSE; 

) 

default: 

return FALSE; 

} 

) 

// callback for EnumChildWindows() 

BOOL FAR PASCAL EnterProc(HWND hWnd.LPARAM RecordParm) 

( 

static HWND hDlg; 
static GLOBALHANDLE hDlglnfo; 
static Dlglnfo far *1pDI; 
char str[80]; 

int id,1tem,max_len,rec_len; 

Dlglteralnfo far *lpDII; 
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data, including embedded nulls. Don't 
be fooled by the declaration of dtil- 
Data as PTR. It's not a pointer, but an 
arbitrary data block of up to 255 bytes 
in size. Windows makes a pointer to a 
copy of this data available to the newly 
created control in the control's 
CREATESTRUCT. Since CREATESTRUCT is 
only available during the processing of 
the UM_CREATE message, this field is 
only useful for superdassed or custom 
controls. 

Listing 1 (bldtmp.c) contains the 
functions used to construct the dialog 
template. The parameters to NewDlg- 
Templatef) are the values for the 
DLGTEMPLATE and FONT INFO structures. 
An empty string (“"), not a NULL pointer, 
is passed for any empty LPSTR argu¬ 
ment. The function allocates space for 
the DLGTEMPLATE and, if necessary, the 
F0NTINF0, and copies the values from 
the argument list. _fmemccpy() is the 
most convenient of the many mem_ and 
str_ functions for the kind of con¬ 
catenation I'm performing here — with 
the arguments given it copies every¬ 
thing up to and including the null byte 
and returns the address of the first byte 
past the copied null - which just happens to be the address 
I'll need to know next. NewDlgTemplatef) returns the handle 
to the global memory block containing the new template. 

AddDlgltemf) adds a control's DLGITEMTEMPLATE to the 
template. It's called for each control in the dialog box. It deter¬ 
mines the current size of the template with TemplateSizef) 
(also from Listing 1) and GlobalReAllocQs the block to ac¬ 
commodate the new item. While copying the values from the 
argument list, it ensures that the HS_CHILD and US_VISIBLE 
styles are set for each control. AddDlgltemf) returns a BOOL 
which is FALSE if the block couldn't be resized. 

The argument list for AddDlgltemf) contains the handle of 
the template and the values for the DLGITEMTEMPLATE fields. 
The remaining parameter, BYTE Type, is an arbitrary non-zero 
value I use to identify the type of the control in an applica¬ 
tion-dependent sense. It is shifted left eight bits and OR' d with 
the current dtltemCount to form the ID for the control. 

Is this “type" information necessary? Well, not for creating 
the dialog box, it isn't - instead it relates to the question I 
raised earlier about how you work with a dialog box created 
on the fly. I'll need the “type” information when DialogProc 
begins handling messages from the controls. 

Putting It Together 

Listing 2 ( intrprtr.c ), Listing 3 (dyndlg.c), and Listing 4 
(dyndlg.h) contain the source for an application which inter¬ 
prets a dialog box definition file and uses it to collect fields for 
a data record. It can handle arbitrary dialog box definitions 
(within its limits) and can maintain several on screen at once. 
It is designed to be easily extendible and could form the basis 
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for a useful utility. Listing 5 (dyndlg. rc ) 
and Listing 6 (dyndlg. def) complete the 
files needed to build the application. 

The Definition 

Figure 1 shows the format for the 
definition file. Each dialog box definition 
resides in its own file. One and only one 
statement appears on a line. Fields are 
delimited by white space. Strings do not 
need quotes except for the special case 
of which is interpreted as an empty 
string. 

The first line of the file consists of 
the string “DIALOG" followed by the cap¬ 
tion, x, y, width, height, a length field 
indicating the size of the output data 
record the box is designed to collect, 
and an item count field specifying the 
number of controls in the dialog. 

Each succeeding line defines a con¬ 
trol. The typename (about which more 
later) is followed by the control’s text, 
x, y, width, and height. The length field 
usually indicates the space the control's 
data should take up in the output 
record but may be interpreted dif¬ 
ferently for different types of controls. 
For example, in a CHECKBOX the length 


Listing 3 continued 


LPSTR Record=(LPSTR)RecordParm; 

rec len“ fstrten(Record); 
id“GetDlgCtrlIO(hWnd); 
if((item*id&OxFF)==0) 

{ 

hDlg=GetParent(hWnd); 
hDlgInfo-GetProp(hDlg,PROP_DLGINFO); 


1pDI=G1obalLock(hDlglnfo); 

1pDII-(lpDI->diItems)+item; 
switch(id»8) 

( 

case TYPE_EDIT: 
case TYPEJUMERIC: 

{ 

GetWindowText(hWnd,str,79); 
max_len*min(1pDII->diiLength,rec_len- 
1pDII->diiPosition); 

_fstrncpy((Record)+1pDII->diiPosition, 
str,min(max_len,strlen(str))); 

SetWi ndowText (hWnd,""); 
break; 

) 

case TYPE_CHECKBOX: 

( 

if(SendMessage(hWnd,BM_GETCHECK,0,0)) 

{ 

if(rec_len>lpDII->diiPosition) 

{ 

Record[1pDII->diiPosition]=1pDII->diiLength; 


Attention: Windows C/C++, Visual Basic, TPW and Object Vision programmers 


flying 'Blind? 

Imagine you're flying a plane with 
the dashboard of the cockpit 
covered up. No speedometer, no 
altimeter, no compass, no 
temperature gauge. . 

Is your program flying like that 
plane? 

Could a pilot stop the plane every 
ten yards, take a peek at the 
dashboard and then cover it up 
again? 

Why should you make do with just 
a source code debugger? 

What your program needs is a dashboard. A graphic display 
running side-by-side with your own windows. If only you could 
pick any variable from your code: 

Display its value. 

*¥ Show it as a dial. 

Plot how it changes over time in a graph. 

Display statistics on it, such as rate of growth, max. etc. 

The display is updated instantly, in real time, without your 
program having to stop, or even slow down. 

Please, have a seat In your own program's cockpit 
TrackDeck™ is the dashboard. 



A NEW DEBUGGING TOOL 

Real time debugging. This is new! 
Graphing variables. This is new! 

An innovation that will let you: 

^ Find bugs instantly. 

^ Understand the internal working of your program. 

^ Get warning of problems before they occur. 

^ Create a customized dashboard for your client. 

Beyond debugging... focus visually on performance, quality 
and algorithm efficiency. 

TRACKDECK: A BREAKTHROUGH FOR EVERY 
PROGRAMMING TASK. 

/ 


Using graphs you will find 
correlations you never suspected 



_How it works_ 

TrackDeck has two parts: The 
Tracker DLL and the 
Dashboard Window. You insert 
a one-line command in your 
code for each variable you want 
to watch. The Tracker monitors 
the value and informs the 
Dashboard window whenever it 
changes. 


TrackDeck is now selling at $129. For discounts, call: 
The Programmer's Connection: 800-336-1166 
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Dashboard Software Ej 4 Louis Ave, Monsey, NY 10952 ® (914)352-8071 
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Listing 3 continued 


SendMessage(hWnd,BM_SETCHECK,O,0); 

) 

} 

break; 

) 

default:; 

} 

G1obalUniock(hDlglnfo); 
return TRUE; 


// Callback for File Open dialog 
BOOL FAR PASCAL FOpenProc(HWND hDlg.UINT Msg, 

WPARAM wParam,LPARAM IParam) 

{ 

switch(Msg) 

{ 

case WMJNITDIALOG: 

return TRUE; 
case WM_COMMAND: 
switch(wParam) 

( 

case IDOK: 

SendMessage(hMainWnd,DYNM_NEWFILE,(WPARAM)hDl g.O); 
EndDialog(hDlg.O); 
return TRUE; 
case 1DCANCEL: 

EndDialog(hDlg.O); 
return TRUE; 
default: 

t 

} 

default: 

t 

) 

return 0; 


LRESULT FAR PASCAL WndProc(HWND hWnd, UINT Msg, 

WPARAM wParam, LPARAM IParam) 

( 

Dlglnfo far * lpDlglnfo; 

GLOBALHANDLE hDlglnfo; 
int i; 

char fi lename[65]; 

PSTR npszRecord; 

switch(Msg) 

< 

case DYNM_CLOSE: 

I 

i=FindDlgBox((HWND)wParam); 

DestroyWindow(hDlgBox[i]); 
hDlgBox[i]=0; 
return 0; 

} 

case DYNM_NEWFILE: 

( 

GetOlgltemText((HWND)wParam,ID_FNAME,fi 1 ename, 64) ; 
i-FindDlgBox(0); 
if(i!=DLG_C0UNT) 

hDlgBox[i]=OpenModelessDialog(fi1ename); 
else 

MessageBox(hWnd,"Too Many Dialog Boxes Open".NULL,MB_0K); 
return 0; 

) 

case DYNM_ENTER: 

{ 

hDl gInfo=GetProp((HWND)wParam,PROP_DLGINFO); 

1 pDl gInfo=Gl obalLock(hDlglnfo); 
i =1pDlgInfo->diRecSize; 

GlobalUnlock(hDlglnfo); 
npszRecord=malloc(i+l); 
if(NULL!=npszRecord) 

( 

*(((PSTR)(memset(npszRecord,' 1 ,i)))+i)“0; 

EnumChildWindows((HWND)wParam,IpEnterProc,(LPARAM)((LPSTR)npszRecord)); 


field is the value of a byte to be in¬ 
cluded in the output record to indicate 
that the item was checked. The position 
field indicates the offset in the output 
record for the control's data. 

All fields must be present for each 
control but the values of length and 
position are ignored for control types 
which don’t produce data for the out¬ 
put record. 

An example may make this clearer: 

DIALOG Dynamic 60 60 160 60 30 4 
LTEXT Name: 10 10 28 12 0 0 
EDIT "" 42 10 108 12 25 0 
CHECKBOX &CHECKME 42 28 48 12 88 29 
ENTERBUTT0N &ENTER 42 44 40 12 0 0 

This definition creates a 160 x 60 dialog 
box at position 60,60. It contains four 
controls and it produces an output 
record 30 bytes long, it contains the fol¬ 
lowing controls: 

• A 28x12 LTEXT containing the text 
“Name:” at 10,10. LTEXTs produce no 
output, so length and position are ig¬ 
nored. 

• A 108x12 EDIT at 42,10 with no ini¬ 
tial text. The text entered in this 
control will be copied to position o 
of the output record for a length of 
25 bytes. 

• A 48x12 CHECKBOX at 42,28. It con¬ 
tains the text "CHECKME” with the 
first “C" as a mnemonic. If checked, 
the value 88 (“X") is placed in posi¬ 
tion 29 of the output record. 

• A 40X12 ENTERBUTT0N at 42,44 with 
the text “ENTER" and mnemonic “E.” 
ENTERBUTTONs don't produce output. 
Please note that when I say that 

ENTERBUTTONs don't produce output, I 
mean they don't produce data for the 
output record. The ENTERBUTT0N is a 
pushbutton used to indicate that the 
dialog box is completed, so of course it 
produces output — a notification mes¬ 
sage —within the application. 

The Interpreter 

The (rather simple-minded) inter¬ 
preter is implemented by the functions 
in Listing 2 (intrprtr.c) and the tables 
defined in Listing 4 ( dyndlg.h ). Read- 
DialogDefO attempts to open a file and 
read a dialog definition. It uses NewDlg- 
Template() and AddDlgItem() to build 
the dialog template and simultaneously 
stores the information needed to form 
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the output record in a Dlglnfo struc¬ 
ture. Dlglnfo's last field is a single-ele¬ 
ment array of struct Dlgltemlnfo. 
Dlglnfo is at the beginning of a 
dynamically allocated block large 
enough to also accommodate Dlgltem- 
Infos for each control in the definition. 
The single element array is used to ad¬ 
dress the extended array. If successful, 
ReadDialogDefO stores the handle for 
the dialog template in the Dlglnfo and 
returns Dlglnfo's handle. 

The action of the interpreter is very 
simple. The lines of the file are read 
with fget()s and the fields are moved 
into variables with sscanf(). Lookup() 
is called to find a match for the 
typename string in the array Type- 
Names[]. Lookup() returns the Type 
value for the control, and this value is 
used as an array index to find the ap¬ 
propriate Style and ClassName values 
for the control. 

As I present it here, the interpreter 
only understands the typenames EDIT, 
CHECKBOX, LTEXT, ENTERBUTTON and 
NUMERIC. I discuss extending it later. 

The Main Loop 

The main application code, including 
the callback procedures, is found in List- 
ing 3 ( dyndlg.c ). Currently active 
dynamic dialogs are stored in the global 
HANDLE array hDlgBox[DLG_COUNT]. 
Note that the standard message loop in 
HinMain() looks a little different than 
usual. The reason for this is that mes¬ 
sages for modeless dialog boxes must 
be processed by IsDialogMessage() to 
provide the standard dialog box key¬ 
board interface. This fragment tests 
each array element first for a handle 
and then for ownership of the message. 
Messages not directed to any of the 
dialog boxes are passed on to the main 
message loop. 

The best way to illustrate the logic 
of the application is to trace the life- 
cycle of a dynamic dialog box from its 
creation. 

The main window of the application 
is nothing but a caption bar with a Sys- 
Menu and a File Menu. The File Open 
selection opens a modal dialog box and 
prompts for the name of a dialog defini¬ 
tion file. When the user has entered a 
filename and hit the Enter key, the 
FOpen dialog procedure sends the applica¬ 
tion defined message DYNM_NEUFI LE to 


Listing 3 continued 


MessageBox((HWND)wParam,npszRecord,"Entered",MB_0K); 
free(npszRecord); 

) 

SendMessage((HWND)wParam,WM_NEXTDLGCTL,0,0); 
return 0; 

} 

case WM_C0MMAN0: 

I 

switch(wParam) 

{ 

default: 

I 

return DefWindowProc(hWnd,Msg,wParam,IParam); 

) 

case IDM_0PEN: 

I 

DialogBox(hInstanceGlobal,“F_0PEN",hWnd,1pFOpnProc); 
return 0; 

} 

) 

} 

case WM_DESTR0Y: 

{ 

for(i=0;i<DLG_C0UNT;i++) 

( 

if(hDlgBox[i]) 

DestroyWindow(hDlgBox[i]); 

} 

PostQuitMessage(0); 
return 0; 

I 

default: 

return DefWindowProc(hWnd,Msg,wParam,1Param); 

I 

I 

// Opens dynamic modeless dialog box. 

// returns handle or NULL on failure. 

HWND OpenModelessDialog(char * filename) 

I 

GL0BALHANDLE hDlglnfo; 

HWND hDlgBox=NULL; 

Dlglnfo far * lpDlglnfo; 

LPSTR lpDlgTmp; 

if(NULL!=(hDlgInfo=ReadDialogDef(filename))) 

I 

lpDlgInfo=GlobalLock(hDlglnfo); 

1pDlgTmp=GlobalLock(1pDlgInfo->dihDlgTmp); 

hDlgBox=CreateDialogIndirect(hInstanceGl obal,lpDlgTmp,NULL,lpDlgProc); 
GlobalUnlock(lpDlgInfo->dihDlgTmp); 

Global Free(lpDlgInfo->dihDlgTmp); 
if(hDlgBox==NULL) 

( 

farfree(1pDlgInfo); 
return NULL; 

) 

) 

GlobalUnlock(hDlglnfo); 

SetProp(hDlgBox,PR0P_DLGINF0,hDlglnfo); 
return hDlgBox; 

} 

// returns the index of the dialog box in hDlgBox[] 
int FindDlgBox(HWND hDlg) 

( 

int i; 

for(i=0;i<DLG_C0UNT;i++) 

I 

if(hDlg==hDlgBox[i]) 
break; 

) 

return i; 

} 

/* End of File */ 
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the main window procedure, UndProcf). 

WndProc() uses FindDlgBox(O) to find an empty slot in 
the array for a new handle. If FindDlgBoxf) returns 
DLG_COUNT, the array is full and a message box is generated; 


otherwise UndProc() calls OpenModeLessDialog() to open the 
definition file. 

OpenModelessDialogO in turn calls the interpreter, Read- 
DialogDef(). If ReadDialogDef () returns a non-NULL Dlglnfo 


Listing 4 dyndlg.h 


/* dyndlg.h */ 

/* defines and structs for Dynamic Dialog Box */ 

lifndef DYNDLG_H 
Idefine DYNDLG H 


typedef struct! 

GLOBALHANDLE dihDlgTmp; 
int diRecSize; 
Dlgltemlnfo diIterns[1]; 
} Dlglnfo; 


Idefine ID_FNAME 3 
Idefine IDM_0PEN 41 
Idefine DYNM_CLOSE WM_USER+1 
Idefine DYNM_ENTER WM~USER+2 
Idefine DYNM_NEWFILE WMJJSER+3 

Idefine DLG_C0UNT 5 
Idefine MAX_STRING 80 

Idefine PR0P_0LGINF0 “DLGINFO" 

Idefine WIND0W_NAME "Dynamic Dialogs" 


typedef struct! 

int diiLength; 

int diiPosition; // in output 
) Dlgltemlnfo; 


Victor 


With color reduction 
for fast, accurate 
24-bit image display 


Image Proce ssing Library 


Create Powerful Image Applications 

for 5MP/TIFF/PCX/GIF/TGA Images 


► 

► 

► 

► 

► 

► 


Load and save 
BMP/TIFF/PCX/GIF/TGA/bin 

Powerful grayscale and color 
image processing: brightness, 
contrast, sharpen, outline, 
equalize, matrix convolution, 
rotate, resize, and more 

Color reduction for fast and 
accurate display of 24-bit 
images 

Scan b/w, grayscale and color 
images with ScanJet scanners 

Print halftones diffusion 
scatters, and color pictures 

Convert images between 1-, 8-, 
and 24-bit formats 

Convert color to grayscale 

Includes a complete image 
processing application with C 
source 



Your Windows application can load and 
save BMP, TIFF. PCX. GIF. and TGA files, 
control scanner and printer, and have 
powerful Image processing and color 
reduction for the very best Image display. 


Victor Image Processing Library 
for Windows (DLL), $295 

Victor Image Processing Library 
(for DOS) supports Microsoft 
and Borland C/C++ compilers, $195 

Call or fax to order 


314-962-7833 


f'Catenary Systems 

470 Belleview St Louis MO 63119 

voice/fax 314-962-7833 

Victor image Processing Library for Windows or for DOS. No royalties. Source code available, visa/mc/cod. 


// function prototypes 

int Lookup(char far ‘key,char far *table[]); 

GLOBALHANDLE NewDlgTemplate(DWORD Style,WORD X.WORD Y, 
WORD CX.WORD CY.LPSTR Menu, 

LPSTR Class.LPSTR Text, 

LPSTR TypeFace.WORD PointSize); 

BOOL AddDlgItem(GLOBALHANDLE DlgTmp,DWORD Style, 

WORD X.WORD Y.WORD CX.WORD CY, 

LPSTR Class.LPSTR Text,BYTE DataLen, 
LPSTR Data,BYTE Type); 

int TempiateSize(GLOBALHANDLE hDlgTmp); 

GLOBALHANDLE ReadDialogDef(char ‘filename); 

HWND OpenModelessDialog(char ‘filename); 

int FindDlgBox(HWND hDlg); 

LRESULT FAR PASCAL WndProc(HWND,UINT,WPARAM,LPARAM); 

BOOL FAR PASCAL DialogProc(HWND,UINT,WPARAM.LPARAM); 

BOOL FAR PASCAL FOpenProc(HWND,UINT,WPARAM.LPARAM); 

BOOL FAR PASCAL EnterProc(HWND hWnd.LPARAM Record); 


extern DLGPROC lpDlgProc; 
extern HINSTANCE hinstance; 

// parser tables 

enum ( 

TYPE_UNUSED,TYPE_EDIT,TYPE_CHECKBOX,TYPE_LTEXT, 
TYPE_ENTERBUTTON,TYPE_NUMERIC, 

TYPE_NAME_COUNT); 

lifdef DEFINE_GL08ALS 

char far *TypeNames[]=("UNUSED","EDIT","CHECKBOX", 
"LTEXT",“ENTERBUTTON", 
"NUMERIC",NULL); 

char far *ClassNames[]=("UNUSED",“EDIT","BUTTON", 
"STATIC","BUTTON","EDIT"); 

long FieldStyles[] = (0, 

WS_TABSTOP | WS_B0RDER, 

WS TABSTOP | BS_AUT0CHECKB0X, 
SS_LEFT, 

BS_PUSHBUTTON | WS_TABST0P, 
WS_TABST0P | WS_B0RDER 


lelse 

extern char far * TypeNames[]; 
extern char far *ClassNames[]; 
extern long FieldStyles[]; 

lendif 

lendif 

/* End of File */ 
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Listing 5 dyndlg.rc 


♦include <windows.h> 

♦include “dyndlg.h" 

DYNOLG MENU 
BEGIN 

POPUP “&File" 

BEGIN 

MENUITEM "&Open..IDM_0PEN 
END 
END 

F_OPEN DIALOG 10,10,102,20 
STYLE WS_POPUP | WSJORDER 
CAPTION "Enter File Name" 

BEGIN 

EDITTEXT ID_FNAME,4,4,94,12,ES_AUT0HSCR0LL | ES_OEMCONVERT 
END 


handle, the dialog template handle is retrieved and locked 
and the pointer is passed to CreateDialoglndirect() . The 
dialog template’s memory block is then Freed. 

I'll need the Dlglnfo structure later to build the output 
record, so hDlglnfo is unlocked and added to the dialog box's 
property list. The dialog box handle returned to HndProcf) 
from OpenModelessDialog() is placed in its slot in the hDlg- 
Box[] array. From here on, the dialog box is open and 
processing its messages. 


Listing 6 

dyndlg.def 

NAME 

DYNDLG 

DESCRIPTION 

‘Dynamic Dialog Box Program 1 

EXETYPE 

WINDOWS 

CODE 

PRELOAD MOVEABLE 

DATA 

PRELOAD MOVEABLE MULTIPLE 

HEAPSIZE 

1024 

STACKSIZE 

5120 

EXPORTS 

DialogProc 


WndProc 


EnterProc 


FOpenProc 


Figure 1 Dialog box definition file format 


DIALOG caption x y width height length itemcount 
typename text x y width height length position 
typename text x y width height length position 


DialogProcf) allows the default dialog procedure to hand¬ 
le most of the processing for the dialog box. It returns TRUE to 
UM_INITDIALOG to allow the default procedure to set the ini¬ 
tial input focus. It traps UM_SYSCOMMAND to process the 
SC_CLOSE command by sending the application defined 
DYNM_CLOSE to the main window. It processes UM_DESTROY to 
remove the Dlglnfo handle from its property list and free it. 



RS232-Toolkit, SuperCom 2.1 
for DOS or Windows 

for MS C/C++, Turbo/Borland C/C++, Turbo Pascal, 
VisualBasic 

SuperCom is the development tool for exacting serial comm¬ 
unication software. That means high data security and fast 
transmission speed. 

SuperCom is fast even in a multitasking operating system 
like Windows. 


1 Interrupt driven: transmission, reception, line status, 
modem status 
1 Buffers to 64K 
1 Up to 115,200 bps 
1 UARTS: 8250,16450,16550 FIFO 
1 Simultaneous COMJ ..COM_32 
1 Any port address 

1 Flow control: RTS/CTS, DTR/DSR, XON/XOFF and 
user defined 

1 Protocols: ASCII, XMODEM, XMODEM/CRC 
1 Timer, Ctrl-Break and Exception handling 
' No resident drivers 
' Direct register programming 
1 Multitasking support (Windows) 


• 386-Technology, Protected Mode Interface (Windows 
only) 

• Interrupt-Sharing 

• Multiserial board support 

• DigiBoard PC/X, PC/Xe, PC/Xi support 

• Modem support 

• Full source code (C or Pascal and optimized ASM) 

• DLL, interface for VisualBasic (Windows only) 

• Windows 3.x (Real, Standard and Enhanced mode) 

• SuperCom ++ (C++ or Pascal OOP) included 

• Compiler support: 

C package (Microsoft C/C++, Borland/Turbo C/C++ 
VisualBasic) 

Pascal package (Turbo Pascal, VisualBasic) 


C or Pascal package for DOS $320 

C or Pascal package for Windows $430 
C or Pascal package for DOS + Windows $570 


VISA/MC 


ADONIS Micro-Software 
Dipl.-Ing. Kiriakos Georgiadis 
Hoelderlinstr. 32 
D-7133 Maulbronn, Germany 
Phone: 49/7043/40449 
FAX: 49/7043/40440 


Fine Line International 
7000 Malone Rd, Forestville 
CA 95436, USA 
Phone: 1/707-887-3400 
FAX: 1/707-887-1015 
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Easy Access To Novell Btrieve 
Under Visual Basic For Windows 

Discover how easy it can be to use Novell's legendary 
Btrieve File Manager under Visual Basic For Windows! 
Our full-featured library offers access to the full power 
of Btrieve v5.1 and a lot more! Create files, add 
supplemental indexes - even the arcane Get Extended 
operations are easy to use with VBtrv. Includes complete 
documentation and sample programs. Available with 
C++ source code for the dynamic-link library for $389. 
Royalty free. 


Btrv++ 


Btrv++ Alone: 
$349 

Bundled With 


Btrvgen++, g2r ++! 

C++ developers: experience order of magnitude 
productivity gains over using the Novell development 
tools alone! More than a dozen classes included, 
covering all aspects of Btrieve v5.1. And with 
Btrvgen++, you can actually generate the C++ classes to 
implement your database schema automatically! Source 
for Btrv++ included. Royalty free. 


Classic Software, Incorporated 

3542 Pheasant Run Circle, Ann Arbor Ml 48108 

Call us for more info or to order at 
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The way DiologProcf) handles the UM_COMMAND message 
demonstrates the use of the control type values that were 
encoded in the control IDs when the dialog template was 
built. The type is retrieved from the ID with the HIBYTE 
macro and used as a switch() key. For the limited set of 
control types interpreted by this application, only two notifica¬ 
tion messages need to be processed. The EN_KILLFOCUS is 
trapped to perform input validation for the TYPE_NUMERIC edit 
control. If focus is being set to another control in the current 
dialog box (determined by comparing hDlg to the parent win¬ 
dow of whoever now owns the focus), the control's current 
text is scanned for invalid values. If any are found, a Message 
Box notifies the user and focus is forced back to the control. 

A UM_COMMAND from a TYPE_ENTERBUTTON (which can only 
be an EN_CLICKED notification) causes a DYNM_ENTER message 
to be sent to WndProcf). This initiates construction of the out¬ 
put record. 

The dialog box handle is passed as wParam for the 
DYNM_ENTER message. UndProcf) retrieves the dialog box's 
Dig Info structure using GetPropf) and allocates space for the 
output record, initializing it to blanks. UndProc() then calls 
EnumChildUindowsO for the dialog box, passing it a pointer to 
the record. 

EnumChildNindows(hParent,lpEnumProc,lParam) calls the 
application-specified callback procedure for each of the child 
windows of hParent, passing IParam to each. The callback 
procedure in this case, EnterProcf), uses the type informa¬ 
tion encoded in the controls' IDs and the output formatting 
values stored in Dlglnfo to construct the output record. At 
the same time, the controls are re-initialized for the next input 
operation. UndProc() displays the finished record in a mes¬ 
sage box, then frees its storage. 

The dialog box is closed through its system menu. As dis¬ 
cussed earlier, the SCCLOSE selection sends a DYNM_CLOSE to 
UndProcf). UndProcf) responds by calling DestroyMindow() 
for the dialog box and clearing its cell in the hDlgBoxf] array. 

Extending the Interpreter 

The interpreter can easily be extended to handle new 
types. Entries must be added in the TYPE_xxx enum, and to 
TypeNamesf], ClassNames[], and FieldStyles[]. Make sure 
the indices of array entries correspond to the new TYPE_. 
Leave TYPEJJNUSED alone in position 0. It's there to prevent a 
zero type value from being generated, since this could cause 
dynamically created IDs to collide with IDOK and IDCANCEL, 
which are produced by the Enter and Escape keys. Add 
whatever code is needed to handle the new type to Dialog- 
Procf) and EnterProcf). 

The interpreter could also usefully be extended to read 
statement types corresponding to the STYLE, FONT, or CLASS 
statements in a resource script, or to allow the user to change 
default styles for a control type. □ 


Page 38 — Windows/DOS Developer’s Journal 


February 1993 















■ Product Spotlight 


39 


Walnut Creek’s CDROMs 

Ron Burk 


The unique nature of software development has spawned 
a thriving industry: public domain and shareware software. In 
case you do not have regular access to one of the many 
electronic networks and forums, you may not be aware that 
you can find large amounts of software source code, tools, 
applications, and utilities there, some for free, and some for 
the price of a relatively inexpensive shareware registration 
fee. By "large," I mean not just megabytes, but gigabytes. 

Of course, all this software ranges in quality from poor to 
excellent, and the sheer size of what is available can be 
daunting if you are in search of a solution to a specific prob¬ 
lem. These problems have spawned a secondary industry — 
companies that, for a fee, sort through, organize, and dis¬ 
tribute public domain and shareware software. One such dis¬ 
tributor with a slightly different approach is Walnut Creek 
CDROM. 

Most vendors in this particular industry sell floppies of 
software by mail. The software is invariably compressed and 
archived in order to pack more software onto the floppy. In 
fact, since many vendors are not adding much value to the 
software, you may see ads touting how many thousands of 
bytes of software you are receiving per dollar. Walnut Creek 
wins this “software-by-the-pound" contest hands-down. At 
about $30 for 420Mb, you are getting roughly 14Mb of 
software per dollar, and that is before you even decompress 
itl 

Walnut Creek CDROM currently offers nine CDROMs; I 
looked at just two that contain large amounts of data avail¬ 
able from various Internet archive sites. If you are active on 
Internet, then you will immediately recognize the names of 
the collections. If not, you will have to settle for some rough 
characterizations of the collections, since it would take many 
pages to enumerate all the items in even one CDROM. Each 
directory in each CDROM contains an index file with a very 
short description of each file in the directory. This is handy, 


since most of the files are .zip files and it would be very 
tedious to decompress them all to find the ones of interest. 

The Simtel20 MSDOS CDROM contains about 600Mb from 
the Internet archive of the same name. This includes utilities 
and programming tools. Some of the tools include source code 
and the language of choice is C, although C++, assembly lan¬ 
guage, Pascal, BASIC, Fortran, and other languages are repre¬ 
sented as well. Here is a smattering of a tiny portion of the 
contents: a directory full of TIFF programming information, in¬ 
cluding source code to deal with reading and writing TIFF files 
and the TIFF v5.0 specification, C source code for a SCSI disk 
driver, C source for VT100 terminal emulation, a tool to con¬ 
vert between ASCII and EBCDIC, with assembly language 
source, two different versions of YACC (a UNIX parser gener¬ 
ator). 

At 200Mb, the CICA Microsoft windows CDROM is a good 
deal smaller than the Simtel20 archive, but it is growing. The 
source code available for DOS in the Simtel20 archive dwarfs 
the amount of Windows programming source code available 
here, but it will still take you some time to look at all the 
code available. Non-code files include lots of bitmaps and 
icons, and games and utilities. For example, you can check out 
a copy of Wilson WindowWare's shareware Windows 
programming editor from this disk. 


Company Information 

Walnut Creek CDROM 

1547 Palos Verdes Mall, Suite 260 

Walnut Creek, CA 94596 

(800) 786-9907 

(510) 947-5996 

(510) 947-1644 FAX 


Ron Burk has a BSEE from the University of Kansas and has been a programmer for 12 years. He is working on a book tentatively 
titled WinHelp for Programmers and Technical Writers. You may contact him at Burk Labs, P.O. Box 3082, Redmond, WA 98073- 
3082. CIS: 70302,2566. BIX: rlburk; Internet- ronb@rdpub.com (". . . luunetlrdpublronb") 
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object-Menu provides an object-oriented architectural 
framework for your application. Our intuitive 
architecture and natural programming syntax increase 
your productivity more than you ever thought possible. 
Seamlessly port your product between DOS graphics 
and Microsoft. Windows using our interface objects. 

Give your Windows apps a facelift: Our library 
includes extensive icon capability and optional 
Motif-styling not found in other Windows API’s. Create 
your own objects easily by extending our class library. 
Our goals are to simplify GUI design for the novice 
while providing the power and flexibility needed by an 
expert. 

Includes windows, icons, scroll bars, menus, buttons, 
tool bars, dialog boxes, data entry, spin control, file 
chooser, combo box, justified page display with 
embedded icons and hypertext primitives, and much 
more. Special features: dynamically change scroll bar 
resolution, mulitple line items, multiple icons for a menu 
item, several menu styling and item selection options, 
compact, natural programming syntax. Special DOS 
features include help and icon libraries, hypertext help 
system, event management, overlapped window manager. 

"The application’s visual components have a sculpted, 
three-dimensional look reminiscent of Motif. ... object-Menu 
can use automatic placement directives to define positioning 
of visual components ... the [object-Menu] scroll bars here 
truly scroll the items in a given window’s display. ... 
Another unique feature is the use of tear-off menus similar 
to those on the MAC and Open-Look." 

D r. Dobbs Journal, October 1992 _ 

"It seems that the designer has gone to a lot of trouble to 
make it as easy as possible to describe GUI elements in 
the most succinct and yet self explanatory way possible. ... 
The support for the hypertext portion of the help system is 
nothing short of excellent." 

Compiler support: Borland C++, Microsoft C++ 

(Ask about MetaWare C++,Watcom C++, Zortech C++) 
Phar Lap 286/386 DOS extender 
DOS Graphics support: BGI, Microsoft graphics, 
MetaWindow, Genus GX, Halo graphics. 
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7 Mountain Rd, Burlington MA 01803 
Tel: (617)273-0421 Fax (617)270-4437 BBS (617)270-9552 
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The company also sells seven CDROMs that I did not ex¬ 
amine, five of which could be of interest to DOS and Windows 
programmers. The Source Code CDROM contains the Usenet 
source archives, the Simtel20 UNIX-C Archive, and a collection 
of DOS source code, for a total of about 600MB. The X11R5 
and GNU CDROM, as the name implies, contains the X11R5 
Window System sources (patchlevel 9), all the GNU source 
code, the Usenet comp.sources.x archives, and SPARC binaries 
and libraries for the GNU programs and the X11R5 server and 
clients. The GIFs Galore CDROM contains over 6000 color im¬ 
ages, including viewers and utilities. The OS/2 Archive CDROM 
is derived from the OS/2 Internet archives at novell.com and 
hobbes.nmsu.edu, and its more than 2,000 OS/2 entries range 
from user utilities to source code. The Garbo MSDOS/MAC 
CDROM is 250Mb of DOS software and 125Mb of Macintosh 
software from the University of Vaasa in Finland. 

Another intriguing offer from Walnut Creek is the custom 
CDROM. For prices starting at $195, you can send them a tape 
or floppies with up to 600Mb of data and have them put it 
onto a CDROM for you. 

The Source Code and XI1R5/GNU CDROMs each cost $39.95, 
and each of the others costs $24.95. Shipping and handling 
costs $5 in the US or Canada, or $10 overseas. California resi¬ 
dents have to add 7.25% sales tax. 

Is this a good deal? Folks with FTP already have convenient 
access to these archives, but most of us are stuck with a 
modem, rather than a high-speed network, as our pipeline to 
the electronic community. You do have to have a CDROM 
drive to use this product; that used to be a rarity, but with 
more software vendors pushing to distribute on CDROM (the 
Windows NT beta is available only on CDROM), more program¬ 
mers have them. Also, the CDROMs lose value over time as 
they get further out of synch with the live archives they were 
derived from. 

If you ever download public domain or shareware software 
from bulletin boards, CompuServe, or the like, it will not take 
many downloads to recoup the cost of a single CD. Why start 
from scratch if you can start with, or at least examine, the 
code of someone who has worked on a similar problem? Why 
pay for a 90-minute long-distance download if you can copy 
the same software from a CDROM in 30 seconds? If you have 
tried keeping your own archive of useful public domain and 
shareware software on floppies, it is easy to be enthusastic 
about the CDROM approach. 

If you are in a programming shop that has a CDROM drive, 
you might want to consider Walnut Creek's subscription ser¬ 
vice; the company will send you a new version of either the 
Simtel or the CICA CDROMs four times a year, for $19.95 per 
quarter. In other words, for about $160 per year, you can 
maintain more than a gigabyte of data in your company’s 
technical library. □ 
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A 3 of 9 Barcode DLL 

Michael Soflin 


Most database systems use an indexing scheme whereby a key value points to a 
larger piece of information in the database. The idea is to let the user enter in a 
small piece of data and have the computer fill in the rest of the information by 
searching the database. In a manufacturing environment, the key values may be 
employee numbers, part numbers, and stock locations. In a retail environment, per¬ 
haps the only key available is a product code. In any case it is important that key 
values be entered into the system correctly by the user. One method to help 
guarantee correct entry is to use barcode technology. 

Any barcode system consists of two parts: a printing part and a collection part. 
Both the collection component and the printing component can be implemented 
either with hardware or with a combination of hardware and software. The 
hardware implementation for the print component requires a printer capable of 
generating barcodes in response to certain escape codes. These custom printers can 
be expensive, depending on the features needed, but there is an alternative. If you 
own a laser printer or even a good dot-matrix printer, you can create your own 

custom barcode library for Windows. Since Windows 
provides a level of device independence, you will be 
able to use any output device that can generate high- 
quality output. 


Microsoft C/C++ v7.0a 
Borland C++ v3.1 


Michael So/lin received an MS degree in Computer Science in 1991 from Grand Valley 
State University. He has been working in the software industry for seven years and 
programming Windows for the last year and a half. Michael currently owns a small 
consulting firm that specializes in Windows database applications. He can be con¬ 
tacted at (313) 327-2485 or on CompuServe at 71543,2125. 
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Ideally, printing barcodes from within a program should be 
very much like making a GDI call. You should be able to pass 
in a device context, positioning and sizing information, and a 
string to be barcoded. My solution consists of a small DLL that 
contains a single exported function called BarCode (). As with 
other GDI functions, the calling program will be responsible for 
getting a device context and setting the mapping modes for 
drawing. 

The 3 of 9 Encoding Scheme 

There are several encoding schemes from which to choose, 
including the familiar Universal Product Code (UPC), now used 
by all supermarkets. Since barcodes generated using UPC are 
limited to the digits 0-9 and I want to encode alphanumeric 


data, the UPC scheme won't work. I required an encoding 
scheme that codes at least digits and letters. The encoding 
scheme most widely accepted for alphanumeric data is called 
"3 of 9.” Using 3 of 9 you can code the characters A-Z, 0-9, -, 
space, *, $, /, +, and %. There also is an extended version of 3 
of 9 that allows the encoding of the full ASCII character set, 
but for this discussion I will stick to the basic 3 of 9 code. 

3 of 9 encoding derives its name from the fact that each 
barcoded character consists of an interwoven pattern of black 
bars and white spaces. Each character consists of five bars and 
four spaces for a total of nine elements per character (the “9” 
in 3 of 9). A character always begins and ends with a black 
bar. Bars and spaces always alternate. Each of the nine ele¬ 
ments of a character is considered to be wide or narrow. In 
any given character there are exactly 3 
(the “3" in 3 of 9) wide elements. 

A common technique is to use two 
bytes to encode each character. The 
first byte uses the lower five bits to 
represent the solid bars of the charac¬ 
ter. A 1 represents a wide bar and a 0 
represents a narrow bar. The lower four 
bits of the second byte encode the 
white spaces. Again, a 1 represents a 
wide space and a 0 represents a nar¬ 
row space. A complete 3 of 9 barcode 
consists of some leading white space, a 
start character (the asterisk), a string of 
data characters as described above, a 
stop character (also an asterisk), and 
some trailing white space. Table 1 
shows a summary of the 3 of 9 encod¬ 
ing scheme and Figure 1 shows the 
character “A” encoded. 

The final aspect of 3 of 9 encoding is 
dimensioning. 3 of 9 barcodes may be 
printed at any number of widths. The 
width of the narrow elements and the 
ratio of wide to narrow elements are 
the two significant parameters. The fol¬ 
lowing requirements must be satisfied 
in order to print readable barcodes: 

• The minimum element size is 0.0075 
inches (0.19 mm). 

• The minimum ratio of wide to nar¬ 
row is 2:1. The ratio must exceed 
2.2:1 if the narrow element is less 
than 0.02 inches (0.5 mm). 

• The maximum ratio of wide to nar¬ 
row is 3:1. 

• The leading and trailing white space 
must have a minimum width of ten 
times the narrow width or 0.10 in¬ 
ches (2.5 mm), whichever is greater. 

• The gap between characters within 
the barcode may be between one 
and three times the width of a nar¬ 
row element or 0.060 inches (1.52 
mm), whichever is greater. 


Your future^ 
These Windows. 




Today, more developers and programming groups 
are turning to Codewright as their vehicle to the 
future -- a future developing in Microsoft Windows. 
You can configure and extend Codewright to work 
the way you work, the way your group works. At 
the same time, Codewright is truly at home in the 
Windows environment. 

Codewright has features to make 
even the best editors envious: Hex 
Edit, Selective Display, Multi-file 
Search and Replace, Difference 
Analysis, Customizable Tool Button 
Bar and Tool Box, File Merging and 
ChromaCoding. We’ve included the 
features you have come to rely on, 
too: Unlimited Undo/Redo, Column 
Marking, Language Templates, 

Compile and Find Errors. And 
Codewright has unsurpassed support 
for Windows v3.1. 

You configure Codewright to your 
preferences through its extensive 
system of dialogs, or by editing its 
initialization file. 
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The professional Programmer’s 
Editor for Microsoft windows. 


You extend Codewright through Dynamic Link 
Libraries (DLLs). Forget those half-hearted C 
macro languages. We provide the C source code 
to our DLLs for you to modify as you please. Or 
you can use any of Codewright’s 600 functions 
in your own DLL that you create with any 
Windows compatible language. 

To see your future in Windows, you 
don't need a crystal ball. Just give 
us a call. You’ll be talking to 
people responsible for highly 
acclaimed software, documentation, 
and support. We’ll arrange for you 
to try Codewright without risk, and 
we’ll tell you about a support policy 
and multi-user pricing designed for 
your future. 


Premia and Codewright are trademarks of Premia Corporation. 
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Table 1 3 of 9 encoding scheme 


• 



Character 

Bar (Binary) 

Spaces (Binary) 

1 

10001 

0100 

2 

01001 

0100 

3 

11000 

0100 

4 

00101 

0100 

5 

10100 

0100 

6 

01100 

0100 

7 

00011 

0100 

8 

10010 

0100 

9 

01010 

0100 

0 

00110 

0100 

A 

10001 

0010 

B 

01001 

0010 

C 

11000 

0010 

D 

00101 

0010 

E 

10100 

0010 

F 

01100 

0010 

G 

00011 

0010 

H 

10010 

0010 

1 

01010 

0010 

J 

00110 

0010 

K 

10001 

0001 

L 

01001 

0001 

M 

11000 

0001 

N 

00101 

0001 

0 

10100 

0001 

P 

01100 

0001 

Q 

00011 

0001 

R 

10010 

0001 

S 

01010 

0001 

T 

00110 

0001 

U 

10001 

1000 

V 

01001 

1000 

W 

11000 

1000 

X 

00101 

1000 

Y 

10100 

1000 

Z 

01100 

1000 

- 

00011 

1000 


10010 

1000 


STOP 


...ERRORS! 


End your listing errors by subscribing to 

Windows/DOS Developer’s Journal 

code listings on disk. 


...HIGHER 

PRODUCTIVITY! 



Save hours of typing in long code listings 
and make better use of your time. 



Call 913-841-1631 TODAY! 

For only $30* you’ll receive 12 disks 
(one per issue) of Windows/DOS 
Developer’s Journal listings. You’ll 
save 50% off the price of buying the 
disks individually! 

If you don’t already subscribe to Win¬ 
dows/DOS Developer’s Journal- 
order both the magazine and disk for 
$59* 

Subscriptions must be prepaid and 
are available on 5.25" or 3.5" 

MS-DOS format only. 


Windows/POS 

D DEVELOPER'S JOURNAL 

1601 W. 23rd. St., Ste. 200 
Lawrence, KS 66046-2743 


•foreign prices vary (call for details) 


February 1993 


Windows/DOS Developer’s Journal - Page 43 






















































Figure 1 3 of 9 Representation of the letter A' 



Given the above information, Table 2 can be constructed. It 
shows some possible options for constructing barcodes using 
3 of 9 encoding. 

Building the DLL 

The device independence and various mapping modes 
provided by Windows make the DLL fairly trivial. The source 
code for the DLL is in barcode, c (Listing 1). When you pass a 
string to the DLL, it prepends and appends the stop character. 
The DLL searches the lookup table for each character in the 
string and uses the two bytes representing the bars and 
spaces to draw the rectangles needed for the character. 

Building the Test Application 

The test application shown in testapp.c (Listing 2) simply 
creates a window and displays the string “Windows/DOS 
Developers Journal” in both human 
readable and barcode form. I use the 
MM_HIENGLISH mapping mode so I can 
give my dimensions in thousandths of 
an inch. I'm outputting the barcode in 
the 8.6 characters per inch mode. Ob¬ 
viously, a barcode on the screen is not 
of much use: the test program simply 
shows the calling sequence needed to 
access the DLL. A real-world application 
would use a device context associated 
with a printer to generate barcoded 
documents or labels. 


Table 2 3 of 9 Dimensions 

Char/Inch 

Narrow Width 

Wide Width 

Ratio Wide:Narrow 

9.40 

0.0075 

0.0168 

2.24 

8.60 

0.0080 

0.0200 

2.50 

5.70 

0.0120 

0.0300 

2.50 

5.40 

0.0115 

0.0345 

3.00 

3.00 

0.0210 

0.0630 

3.00 

1.70 

0.0400 

0.1000 

2.50 


Listing 1 DLL to print barcodes 

// *BX*3B****SSSSSSSS2SS==SSZS=SSS=S=SSXS===3S>BS 

{' J * . 6, 2), // 00110 0010 

// Listing 1 - barcode.c Barcode DLL source code 

('K'. 17, 1), // 10001 0001 

H 

N 

II 

II 

II 

II 

II 

N 

II 

II 

II 

II 

II 

II 

II 

II 

II 

II 

II 

II 

II 

II 

II 

II 

H 

II 

H 

II 

II 

II 

II 

II 

II 

It 

II 

II 

U 

II 

II 

CL', 9, 1), // 01001 0001 


CM', 24, 1), // 11000 0001 

♦define STRICT 

('N\ 5, 1), // 00101 0001 

♦define WINVER 0x0300 

('O’, 20, 1), // 10100 0001 


{ ’P' , 12. 1), // 01100 0001 

♦include <windows.h> 

('Q', 3,1), // 00011 0001 

♦include <string.h> 

('R\ 18, 1), // 10010 0001 

linclude "barcode.h M 

{’S', 10. 1), // 01010 0001 


{ • T ’ , 6, 1), // 00110 0001 

♦define TABLESIZE 44 

j'U', 17, 8), // 10001 1000 


i'V, 9, 8), // 01001 1000 

struct 

{'W, 24, 8), // 11000 1000 

( 

('X', 5, 8), // 00101 1000 

char c; 

j'Y’, 20, 8), // 10100 1000 

BYTE bar; 

i'Z', 12, 8), // 01100 1000 

BYTE space; 

3. 8), // 00011 1000 

i 

18, 8), // 10010 1000 

be [TABLESIZE] « ({'1', 17, 4), // 10001 0100 

C ', 10, 8), // 01010 1000 

('2', 9. 4), // 01001 0100 

('*', 6, 8), // 00110 1000 

('3'. 24. 4), // 11000 0100 

('$', 0,14), // 00000 1110 

('4'. 5. 4), // 00101 0100 

('/', 0,13). // 00000 1101 

('5', 20. 4), // 10100 0100 

('+', 0,11), // 00000 1011 

{ ’6 ’ . 12, 4}, // 01100 0100 

('%', 0,7}); // 00000 0111 

{ ’7’. 3, 4), // 00011 0100 


('8', 18. 4). // 10010 0100 

Ipragma argsused 

('9'. 10. 4), // 01010 0100 

B00L FAR PASCAL LibMain { 

{'O', 6, 4). // 00110 0100 

HINSTANCE hModule, 

{' A * . 17, 2). // 10001 0010 

WORD wDataSeg, 

{• B 1 , 9. 2), // 01001 0010 

WORD cbHeapSize, 

CC, 24, 2), // 11000 0010 

LPSTR lpCmdLine) 

('D', 5.2), // 00101 0010 

// . 

(' E * , 20. 2), // 10100 0010 

// Entry point into the DLL 

('F', 12, 2), // 01100 0010 

// . - 

('G', 3,2), // 00011 0010 

( 

('H', 18, 2), // 10010 0010 

if (cbHeapSize ! = 0) UnlockData (0); 

('I', 10, 2), // 01010 0010 

return (TRUE); 
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Summary 

Barcodes can be a useful tool. The algorithms tend to be 
simple to write — the real work comes in understanding the 
various encoding schemes. Using Windows allows you a great 
deal of flexibility when selecting output devices. □ 


Address Correction for Crescent Software 

Crescent Software 
11 Bailey Avenue 
Ridgefield, CT 06877-4505 

An incorrect address appeared in January's New Products. 


Listing 1 continued 

Int x. 

while (*sz) 

int y. 

I 

int iWlde, 

// find the character in the lookup table 

int iNarrow, 

for (1=0; i<TABLESIZE; i++) 

Int (Height, 

( 

LPSTR szBarcode) 

if (*sz be[i ] .c) 

//. 

< 

// Print a barcode 

// loop through the bars 

//. 

for (j=0; j<5; j++) 

/ 

BYTE 

// print the bar 

mask [5] - (16, 8. 4, 2, 1}; 

IWidth * (bc[1].bar 6 mask [j]) ? IWlde : (Narrow; 

Int 

Rectangle (hdc, xPos, y, xPos + iWidth, y + iHeight); 

i. 

xPos ♦= iWidth; 

j. 

// always end with a bar 

iWidth, 

If (j =* 4) break; 

xPos; 

// move over the space 

LPSTR 

xPos +* ( be[i].space & mask [j+1]) ? iWide : INarrow; 

sz; 

) 

char 

// Print an Inter-character gap 

szTemp [255]; 

xPos ♦* INarrow; 


break; 

// check for too long of a string 

i 

if ( fstrlen (szBarcode) > slzeof (szTemp) + 3) return (FALSE); 

i 


sz++; 

// process the string 

} 

xPos ■ x; 

return (TRUE); 

wsprintf (szTemp, "*%s* M , szBarcode); 

i 

sz = (LPSTR) szTemp; 

/* End of File */ 
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Listing 2 Program to test barcode DLL 


n 

n 

n 

ii 

ii 

ii 

ii 

ii 

n 

ii 

!! 

ii 

M 

H 

n 

ii 

H 

ii 

ii 

ii 

H 

ii 

n 

n 

ii 

ii 

ii 

ii 

ii 

ii 

u 

H 

ii 

ii 

H 

ii 

ii 

ii 

H 

n 

ii 

ii 

H 

II 

II 

II 

II 

II 

II 

ShowWindow (hwnd. nCmdShow) ; 

// Listing 2 testapp.c - Simple test application for barcode dll 

UpdateWindow (hwnd) ; 

" ... 


while (GetMessage (&msg, NULL, 0, 0)) 

#define STRICT 

( 

♦define WINVER 0x0300 

TranslateMessage (&msg) ; 

DispatchMessage (&msg) ; 

♦include <windows.h> 

i 

linclude <string.h> 

return msg.wParam ; 

linclude "barcode.h" 

i 

long FAR PASCAL WndProc ( 

long FAR PASCAL WndProc ( 

HWND hwnd, 

HWND hwnd. 

UINT message. 

UINT message. 

WPARAM wParam, 

WPARAM wParam, 

LPARAM 1 Param); 

LPARAM 1Param) 

// . 

Ipragma argsused 

// Main program 

int PASCAL WinMain ( 

// . 

HINSTANCE hlnstance. 

( 

HINSTANCE hPrevInstance, 

HDC hdc; 

LPSTR IpszCmdParam, 

PAINTSTRUCT ps; 

int nCmdShow) 

static char 

//. 

sz [] = "Windows/DOS Developers Journal"; 

// Main Program 


// . 

switch (message) 

/ 

static char szAppName[] * "TestApp"; 

case WM PAINT: 

HWND hwnd ; 

hdc = BeginPaint (hwnd, &ps) ; 

MSG msg ; 

SetMapMode (hdc, MM HIENGLISH); 

WNDCLASS wc ; 

SelectObject (hdc, GetStockObject (BLACK BRUSH)); 

BarCode (hdc, 500. -500, 80, 20, -500, sz); 

if (IhPrevInstance) 

TextOut (hdc, 1250, -1000, sz, strlen (sz)); 

( 

EndPaint (hwnd, &ps) ; 

wc.style = CS HREDRAW | CS VREDRAW ; 

return 0 ; 

wc.lpfnWndProc = WndProc ; 


wc.cbClsExtra = 0 ; 

case WM DESTROY: 

wc.cbWndExtra * 0 ; 

PostQuitMessage (0) ; 

wc.hlnstance = hlnstance ; 

return 0 ; 

wc.hlcon = Loadlcon (NULL, IDI APPLICATION) ; 

i 

wc.hCursor ■ LoadCursor (NULL, IDC ARROW) ; 


wc.hbrBackground = GetStockObject (WHITE BRUSH) ; 

return DefWindowProc (hwnd, message, wParam, IParam) ; 

wc.lpszMenuName * NULL ; 

) 

wc.lpszClassName = szAppName ; 

/* End of File */ 

RegisterClass (Swc) ; 

} 

hwnd » CreateWindow ( 

szAppName, "Barcode Test Program", WS OVERLAPPEDWINDOW, 

CW USEDEFAULT, CW USEDEFAULT, CW USEDEFAULT, CW USEDEFAULT, 
NULL, NULL, hlnstance. NULL) f 
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Custom Toolbars 


Mark Szamrej' 


Toolbars that allow quick access to frequently used commands are becoming a 
standard for Windows applications. There are two basic toolbar styles. The first is the 
floating “tool palette,” which is a small window the user can move about the screen. 
The second type is the fixed “ribbon bar," or “icon bar,” which typically lies across 
the top of a window just below the menu. 

Toolbars are no free lunch for the programmer. Apart from the coding required, 
bitmaps must be drawn, and these consume more resources than menu items. Used 
in moderation, however, toolbars provide a real benefit by allowing instant access to 
common commands. International applications also benefit, since a button with a 
little printer on it means the same thing regardless of what part of the world you 
happen to be in. 


Mark Szamrej spent six years as a senior engineer developing high-speed systems for 
testing Air Force fighter aircraft. He currently works for Fujitsu Networks Industry 
where he develops LAN-based software and performs "key algorithm" work. He can 
be reached at (315) 891-3340. 
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WINDOWS SERIAL & MS-DOS 
COMMUNICATIONS DONE THE 
RIGHT WAY 


COMM-DRV is a professional serial communication 

library, that includes TSRs. DLLs, and device drivers. 

• Support for most Smart & Dumb Multiport cards. 

• Link libraries into application, or TSRs, or DLLs. 

• C, Assembly, Quickbasic, Visual Basic, Microsoft 
& Borland Windows SDK compatible. 

• Full source for X, Y, & Zmodem file transfer 
libraries, & screen/keyboard libraries. 

• Remote screen management with remote ANSI 
emulation (window scrolling, erasing, etc.). 

• Unlimited number of ports active concurrently. 
Bauds up to 115.2K. Re-entrant code. 

• Asynchronous and timed callbacks to user written 
routines. 

• Real-Time serial port monitor for debugging appli¬ 
cation in real time. 

• 16550A. 16450. 8250 auto detection. 

• Desqview', Procomm DOS/Windows. pc Anywhere 
compatible. 

• Several Windows and MS-DOS examples. 

• One API to learn. All functions behave the same 
under Windows in all modes & MS-DOS. 


Library Sources, Device Driver, TSR $189.95 

Develop Serial Communication 
Applications In English 

COMM-LOG is a collection of programs & TSRs 
for developing custom applications through our 
simple english like full featured script language. 
These programs may be spawned from user applica¬ 
tion or called via an API. 

• True background X&Ymodem file transfers on 
several ports concurrently. 

• Run several scripts concurrently in the back¬ 
ground. foreground, or from application. 

• Built in script language debugging support. 

• Complete data logging support. 

Programs, TSRs and multiple examples $189.95 

MS-DOS Multitasking Kernel 

MTASK is a robust multitasking kernel for develop¬ 
ing cooperating multitasking TSRs and programs 
with several threads of execution. Full task control, 
including mailboxes, TSR building routines, IPCs, 
task blocking, sleeping. RTC control, much more!!! 


TSRs, Libraries, & Examples $89.95 


Multiport Cards 


Four Port Multiport card w/16450 

$110.00 

Four Port Multiport card w/16550A 

$170.00 

Eight Port Multiport card W/16550A 

$225.00 


WCSC Tel. 800-966-4832 

2470 S. Dairy Ashford Tel. 713-498-4832 

Suite 188 Fax 713-568-3334 

Houston, TX 77077 BBS 713-568-6401 


Visa / Mastercard / American Express / COD / CHECK/ P.O. 


The Toolbar 

I have implemented a set of reusable routines that can 
help you add a toolbar to your application. To demonstrate 
the routines, I have written a regular (non-toolbar) application, 
to which I then add a toolbar. As you will see, adding a tool¬ 
bar to existing code is a relatively simple task: the main ap¬ 
plication has only to define and create a toolbar in order to 
use it Toolbars are self-sufficient and need no special atten¬ 
tion from the main application. 

I use window messages to communicate between the 
main application and a toolbar. My toolbars send WM_COM- 
MAND messages that look like, and get processed as, menu 
selections. The toolbar code supplies a basic but functional API 
(see Table 1) you can use to query and control the toolbar 
state. 

The toolbar code is completely re-entrant and allows for 
multiple toolbars. I implemented the toolbar as a separate 


Table 1 The toolbar API 

Function calls 

HWND CreateToolBarfhwnd, LONG style) 

Where: 

hwnd - is the window that owns the toolbar 
style - is TBS_FLOAT or TBS_FIXED 

The return value is the window handle of the toolbar. 


Properties 

Set the property list of the toolbar window by calling 
SetPropO. 

NOTIFY - Sets window to receive all toolbar 
messages. 

TALL - Initial height of the toolbar. 

WIDE - Initial width of the toolbar. 

A TBM_DESTROYED message is sent to the window set 
by the NOTIFY property when the toolbar is destroyed. 
wParam is the toolbar handle. 


Messages 

TBMJNITIALIZE (Initialize toolbar) 

Where: 

wParam - points to TB_DATA structure. 

IParam - is a count of items in TB DATA structure. 

TBM_GETSTATE (Get a button state) 

Where: 

wParam - is the ID value of button (ex: IDM_RED). 
Returns - the button state (defined in toolbar.h). 

TBM_SETSTATE (Set a button state) 

Where: 

wParam - the ID of the button to set. 

IParam - the new button state. 

Returns - TRUE if successful else FALSE. 

TBM_SETMYMENU (Check menu items) 

Where: 

wParam - is the handle of the menu to set. 

TBM_MENUPICKED (Menu item selected) 

Where: 

wParam - ID of selected menu item. 

Returns - TRUE if successful else FALSE. 
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Listing 1 host.c - Demonstration program for toolbar routines 

/* . 

print(hwnd, “RED text"); 

Listing 1 - HOST.C (Host program for toolbar demo) 
. */ 

linclude <windows.h> 

return 0; 

case IDM GREEN: 
textColor=RGB(0,128,0) ; 

#include "host.h“ 

print(hwnd, "GREEN text"); 


return 0; 

/* .GLOBAL VARIABLES. */ 


LONG textColor=RGB(255,0,0) ; 

case IDM BLUE: 

BOOL invert=FALSE; 

textColor=RGB(0,0,255); 

/* .WIN MAIN. */ 

print(hwnd, "BLUE text"); 
return 0; 

int PASCAL WinMain(HANDLE hlnst, HANDLE hPrevInst, 


LPSTR lpCmdLine, int nCmdShow)( 

case IDM INV: /* Toggle text mode */ 

MSG msg; 

invert=(invert) ? FALSE : TRUE; 

WNDCLASS class; 

if(invert) 

HWND hwnd; 

print(hwnd, "INVERTED text 11 ); 

if(IhPrevInst) { /** Register window class **/ 

else print(hwnd, "REGULAR text"); 

return 0; 

class.style = NULL; 


class.lpfnWndProc * MainWndProc; 

case IDM CLEAR: /* Send a NULL handle */ 

class.cbClsExtra = 0; 

print(hwnd, NULL); /* to clear the window*/ 

class.cbWndExtra = 0; 

return 0; 

class.hlnstance = hlnst; . 


class.hlcon = LoadIcon(NULL, IDI APPLICATION); 

case IDM BEEP: /* Sound the beeper */ 

class.hCursor = LoadCursor(NULL, IDC ARROW); 

MessageBeep(O) ; 

class.hbrBackground = GetStockObject(WHITE BRUSH); 

print(hwnd, "Beep-Beep!"); 

class.lpszMenuName = "MainMenu"; 

return 0; 

class.IpszClassName = "HostClass"; 


RegisterClass(&class); 

case IDM TB SHOW: /* Create the toolbar */ 

) 

return 0; 

) 

break; 

/**** Create the main window ****/ 

hwnd=CreateWindow("HostClass", “Host Program", 


WS OVERLAPPEDWINDOW, CW USEDEFAULT, CW USEDEFAULT, 

case WM DESTROY: 

320, 400, NULL, NULL, hlnst, NULL); 

PostQuitMessage(O) ; 

ShowWindow(hwnd, nCmdShow) ; 

break; 

) 

UpdateWindow(hwnd); 

return(DefWindowProc(hwnd, message, wParam, IParam)); 

while (GetMessage(&msg, NULL, NULL, NULL) ) { 

} 

TranslateMessage(&msg) ; 


DispatchMessage(&msg) ; 

/* Print a line of text and move cursor position */ 

) 

void print(HWND hwnd, char *string)( 

return (msg.wParam); 

HDC hdc; 

) 

static int row=0; 

/* -MainWndProc....*/ 

extern LONG textColor; 
extern BOOL invert; 

long FAR PASCAL MainWndProc(HWND hwnd, UINT message, 


WPARAM wParam, LPARAM lParam){ 

if(string==NULL) { /* Clear display if there */ 

void print(HWND, char *); 

row=0; /* is NO text to display */ 

extern LONG textColor; 

REDRAW(hwnd); /* Update the window. */ 

extern BOOL invert; 

return; 

) 

switch(message) ( 

case WM COMMAND: 

hdc=GetDC(hwnd) ; /* Get DC and Set Colors */ 

if(invert) { 

/* MENU item */ 

SetTextColor(hdc, RGB(255,255,255) ); 

switch(wParam) ( 

SetBkColor(hdc, textColor); 


) else SetTextColor(hdc, textColor); 

case IDM ABOUT: /* Poor mans about box! */ 


print(hwnd, "About the program.... 11 ); 

/* Output the text and inc. row */ 

MessageBox(NULL,"Toolbar Test”,"Msg”,MB OK); 

TextOut(hdc,0,row,(LPSTR)string, 1 strlen(string) ); 

return 0; 

row+=HIWORD(GetDialogBaseUnits ()); 

case IDM EXIT: 

ReleaseDC(hwnd, hdc); 

} 

PostMessage(hwnd, WM DESTROY, 0, OL) ; 

/* End of File */ 

break; 

case IDM RED: 
textColor=RGB(255,0,0) ; 
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window procedure rather than putting the code in a DLL. 
There are advantages to both methods, but I find that many 
Windows programmers are more comfortable working with 
regular code than with a DLL. Theoretically, a DLL would only 
get loaded once if multiple applications were to use a toolbar. 
This is great news but probably irrelevant for most applications. 


Listing 2 host.h 
program 

- Header for demonstration 

Idefine IDM EXIT 

100 /* Menu item choices */ 

Idefine IDM ABOUT 

105 

Idefine IDM TB SHOW 

200 

Idefine IDM RED 

300 

Idefine IDM GREEN 

305 

Idefine IDM BLUE 

310 

Idefine IDM INV 

315 

Idefine IDM CLEAR 

320 

Idefine IDM_BEEP 

400 

/************ m A C R 0 

£ ******★★*★★★/ 

Idefine REDRAW(x) InvalidateRect((x).NULL,TRUE) 

Idefine HINST(x) GetWindowWord((x),GWW_HINSTANCE) 

long FAR PASCAL MainWndProc(HWND,UINT,WPARAM.LPARAM); 

int PASCAL WinMain(HANDLE,HANDLE,LPSTR,int); 

/* End of File */ 



Listing 3 host.rc — Resource compiler file for 
demonstration program 


lindude 

“windows.h" 


linclude 

"host.h" 


RED 

BITMAP 

red.bmp 

GREEN 

BITMAP 

green.bmp 

BLUE 

BITMAP 

blue.bmp 

REG 

BITMAP 

req text.bmp 

INV 

BITMAP 

inv text.bmp 

CLS 

BITMAP 

els.bmp 

DING 

BITMAP 

bell out.bmp 

DONG 

BITMAP 

bell in.bmp 

ABOUT OUT 

BITMAP 

about 0.bmp 

ABOUT IN 

BITMAP 

about_I.bmp 


MainMenu MENU 
BEGIN 

POPUP "&File" 

BEGIN 

MENUITEM "E&xit", IDM EXIT 

MENUITEM "SAbout Generic...", IDM~AB0UT 
END 

POPUP "&T 00 Ibar" 


BEGIN 


MENUITEM "&Show\ 

IDM_TB_SH( 

END 


POPUP "Te&xt" 


BEGIN 


MENUITEM "&Red\ 

I DM RED 

MENUITEM "SGreen", 

I DM GREEN 

MENUITEM "&Blue“, 

IDM~BLUE 

MENUITEM SEPARATOR 


MENUITEM "Mnverse", 

IDM INV 

MENUITEM "&Clear", 

IDM_CLEAR 

END 


MENUITEM "&Beep!", 

IDM_BEEP 


END 


The Host Program 

The host program for the toolbar ( host.c) is shown in List¬ 
ing 1. It is a simple program that outputs red, green, or blue 
text to the screen, in normal or inverse video. The program 
also offers an “About" box and the ability to emit a speaker 
beep. 

The other source code files you need to build the host 
program are: host.h (Listing 2) and host.rc (Listing 3), as well 
as the toolbar support routines in toolbar.h (Listing 4), tool¬ 
bar, c (Listing 5), and button.c (Listing 6). The version of host.c 
in Listing 1 does not access the toolbar routines; the rest of 
this article presents the changes necessary to call the toolbar 
routines to add toolbar support. As part of adding toolbar sup¬ 
port, you will also need the bitmaps for the toolbar button 


Listing 4 toolbar.h — Header file for toolbar 
routines 


/***** Tool Bar Messages ****•/ 
Idefine TBM_DESTROYED WM_USER+1 
Idefine TBM_INITIALIZE WM USER+2 
#define TBM_GETSTATE WM_USER+3 
#define TBM_SETSTATE WMJJSER+4 
Idefine TBM SETMYMENU WM~USER+5 
Idefine TBM~MENUPICKED WM_USER+6 

/♦**** Tool Bar Styles ****»/ 


Idefine TBS ESCAPE 0x8000 

Idefine TB MOVE 0x0001 

Idefine TB~NEXT_R0W 0x0002 

Idefine TBS RADIO 0x0001 

Idefine TBS~PUSH 0x0002 

Idefine TBS_T0GGLE 0x0004 

Idefine TBS_0WNFX 0x0008 

/***** Tool Bar Positions *»***/ 
Idefine TBP0S PUSH 0x0001 

Idefine TBPOSJORM 0x0002 

/***** Tool Bar Extra Bytes *****/ 
Idefine TB_PTR 0 

Idefine TB_C0UNT 2 


/* Window styles for Floating & Fixed toolbars */ 
Idefine TBSTYLE_FL0AT WS_P0PUP|WS_CAPTI0N|WS_SYSMENU 

Idefine TBSTYLE~FIXED WS_P0PUP 

/***** Tool Bar Data structure »****/ 
typedef struct tagTB_DATA( 
char *bmNorm; 
char *bmPush; 

WORD style; 

UINT msgjd; 
int state; 
int group; 

HWND hwnd; 

)TB_DATA; 

/***** Function Declarations **»**/ 
long FAR PASCAL ToolWndProc(HWND,UINT,WPARAM.LPARAM); 
long FAR PASCAL ButtonProc(HWND,UINT,WPARAM.LPARAM); 
BOOL FAR PASCAL EnumButtons(HWND, DWORD); 

HWND CreateToolBar(HWND, LONG); 

void CreateTB_Btns(HWND,TB_DATA *, int); 

void PopRadioBtns(HWND, TB_DATA *); 

/* End of File */ 
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Listing 5 toolbar.c - Source code for toolbar routines 


lindude <windows.h> 

lindude "toolbar.h" 

lindude "host.h" 

HWND CreateToolBar(HWND hwnd, LONG style)! 
static BOOL blnit-FALSE; 

WNDCLASS class; 

if(Iblnit){ 

blnit=TRUE; /*** Only do this once ***/ 

class.IpszClassName ■ "ToolBarClass"; 

class.lpfnWndProc = ToolWndProc; 

class.style * NULL; 

class.cbClsExtra * 0; 

class.cbWndExtra * 4; 

class.hlnstance = HINST(hwnd); 

class.hlcon - LoadIcon(NULL, IDI_APPLICATION); 

class.hCursor ■ LoadCursor(NULL, IDC_ARR0W); 

cl ass.hbrBackground* GetStockObject(LTGRAY_BRUSH); 

class.lpszMenuName = NULL; 

RegisterClass(&class); 

cl ass.IpszClassName = “ToolBarButtonClass"; 
class.lpfnWndProc = ButtonProc; 
class.cbWndExtra ■ 2; 
class.hlcon « NULL; 

RegisterClass(&class); 

} 

return(CreateWindow("ToolBarClass", "Tools", style, 

0, 0, 200, 100, 

hwnd, NULL, HINST(hwnd), NULL)); 


/* -Main Toolbar Procedure-*/ 

long FAR PASCAL ToolWndProc(HWND hwnd, U1NT message, 
WPARAM wParam, LPARAM IParam)! 

TB_DATA *button; 
int i; 

switch (message)! 

case TBMJNITIALIZE: 

SetWindowWord(hwnd,TB_PTR,(WORD)(TB_DATA *)wParam); 
SetWindowWord(hwnd,TB_COUNT, (WORD)lParam); 
CreateTB_Btns(hwnd,(TB_DATA *)wParam,(int)lParam); 
return 0; 

case TBM_GETSTATE: 

button*(TB_DATA *)GetWindowWord(hwnd, TB_PTR); 
i=(WORD)GetWindowWord(hwnd, TB_C0UNT); 
while(i-) 

if(button[1].msg_id ** wParam) 
return (long) button[wParam].state; 
return 0; 

case TBM_SETMYMENU: 

button*(TB_DATA *)GetWindowWord(hwnd, TB_PTR); 
i=(WORD) GetWindowWord(hwnd, TB_C0UNT); 
while(i-) 

if(button[i].state ** TBPOS_PUSH) 
CheckMenultem(wParam, button[i].msg_id, 
MF_CHECKED); 

else 

CheckMenuItem(wParam, button[i].msg_id, 
MF_UNCHECKED); 

return 0; 

case TBM_MENUPICKED: 

button*(TB_DATA *)GetWindowWord(hwnd, TB_PTR); 

1«(WORD)GetWindowWord(hwnd, TB_C0UNT); 


whi 1 e (i—) { 

if(button[i].msg_id -* wParam)( 
if(button[i].style == TBS_PUSH) 
return 1; 

if(button[i].style ** TBS_RADI0) 

return SendMessage(hwnd, TBM_SETSTATE, 
wParam, (1ong)TBPOS_PUSH); 
1f(button[i].style ** TBS_T0GGLE)( 
if(button[i].state — TBP0S_PUSH) 
SendMessage(hwnd, TBM_SETSTATE, wParam, 
(long) TBP0S_N0RM); 

else if(button[i].state == TBP0S_N0RM) 
SendMessage(hwnd, TBM_SETSTATE, wParam, 
(long) TBP0S_PUSH); 

return 1; 

) /* If it is a toggle button style */ 

) /* Correct button (msg_id==wParam) */ 

} /* while(i-) loop thru all buttons */ 

return 0; 

case TBMJETSTATE: 

button*(TB_DATA *)GetWindowWord(hwnd, TB_PTR); 
i*(WORD) GetWindowWord(hwnd, TBC0UNT); 

while(i-) ( 

if(button[i].msg_id »» wParam)( 
button[i].state=(W0RD)lParam; 
REDRAW(button[i].hwnd); 
if(button[i].style == TBS_RADI0) 
PopRadioBtns(hwnd, &button[i]); 
return TRUE; 

) 
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Listing 5 continued 


} 

for(i=0; i<count; i++){ 

return FALSE; 

if(button[i].style == TBS_ESCAPE){ 
if(button[i].msg id «■ TB MOVE){ 

case WM SH0WWIND0W: 

xpos+=button[i].state; 

if(GetWindowLong(hwnd, GWL STYLE) & WS CAPTION)( 

ypos+=button[i].group; 

SetWindowPos(hwnd, 0, 0, 0, 

) 

GetProp(hwnd,"WIDE"), GetProp(hwnd,“TALL”), 

else if(button[i].msg id ** TB NEXT ROW){ 

SWP N0M0VE | SWP N0Z0RDER | SWP N0ACTIVATE); 

xpos=0; 

) 

ypos-tallest; 

break; 

) 

continue; 

case WM DESTROY: 

) 

if(GetProp(hwnd,"NOTIFY")) 

hBitmap=LoadBitmap(HINST(hwnd),button[i].bmNorm); 

SendMessage(RemoveProp(hwnd,"NOTIFY"), 

Get0bject(hBitmap, sizeof(BITMAP),&bm) ; 

TBM DESTROYED, hwnd, 0L) ; 

DeleteObject(hBitmap) ; 

RemoveProp(hwnd,"TALL") ; 


RemoveProp(hwnd,"WIDE") ; 

hButton=CreateWindow( 

break; 

"ToolBarButtonClass".NULL,WS VISIBLE|WS CHILD, 

) 

xpos,ypos, bm.bmWidth, bm.bmHeight, 

return (DefWindowProc(hwnd, message, wParam, IParam)); 

1 

hwnd, NULL, HINST(hwnd), NULL); 

SetWindowWord(hButton, 0, (WORD) &button[i]); 

/* Creates toolbar buttons from TB DATA struct */ 

button[i].hwnd-hButton; 

void CreateTB Btns(HWND hwnd, TB DATA ‘button, 

xpos+=bm.bmWidth; 

int count)) 

widest=max(xpos, widest); 

HWND hButton; 

tal 1 est=max(ypos+bm.bmHeight,, tal1est) ; 

BITMAP bm; 

) 

HBITMAP hBitmap; 


int i, xpos, ypos, widest, tallest; 

if(!GetProp(hwnd,"TALL")) { 
tal1est+=GetSystemMetrics(SM CYMENU) ; 

widest=tal1est=xpos=ypos=0 ; 

tal1est+=3*GetSystemMetrics(SM_CYB0RDER) ; 

SetProp(hwnd,“TALL",tallest) ; 


a9?J, 


^3 ~ 
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faces. The bitmaps i used are 32x32 pixels by 16 colors and 
are listed in host.rc. These are supplied on the code disk. 

host.c is a typical Windows program. Menu items are 
processed via UM_COMMAND messages to perform simple ac¬ 
tions. Compile the program using a small or medium memory 
model, then spend a minute or two using it to see how it 
works. There is a menu item to display the toolbar, although 
it will not be functional until you begin making the changes 
needed to add toolbar support. 


Listing 5 continued 


} 

if(!GetProp(hwnd,"WID£")){ 
widest+=2*GetSystemMetrics(SM_CXB0RDER) 
SetProp(hwnd,"WIDE", widest); 


/* End of File */ 


Listing 6 button, c - Source code for button support 


linclude <windows.h> 

linclude "toolbar.h“ 

linclude "host.h" 

Idefine WHITEPEN CreatePen(PS_S0LID,0,RGB(255,255,255)) 
Idefine GRAYPEN CreatePen(PS_S0LID,0,RGB(128,128,128)) 
BOOL ButtonLogic(HWND); 

void DrawButton(HWND); 

long FAR PASCAL ButtonProc(HWND hwnd, UINT message, 
WPARAM wParam, LPARAM lParam){ 

TB_DATA 'button; 

HWND hwndNotify; 

switch(message)! 
case WM_PAINT: 

ValidateRect(hwnd, NULL); /* Satisfy windows */ 
DrawButton(hwnd); /* Draw the button */ 

break; 


case WM_DESTROY: /* Getting destroyed */ 

button*(TB_DATA *) GetWindowWord(hwnd, 0); 
button->hwnd=NULL; /* Dereference handle*/ 

break; 

case WM_LBUTT0ND0WN: /* Button was pressed?*/ 

button*(TB_DATA *) GetWindowWord(hwnd, 0); 
if(ButtonLogic(hwnd)){ /* Status did change */ 

hwndNotify=GetProp(GetParent(hwnd)."NOTIFY"); 
if(hwndNotify) /* If need to notify */ 

SendMessage(hwndNotify, WM_COMMAND, 
button->msg_id, -1L); 
if(button->style =* TBS_RADI0) 
PopRadioBtns(GetParent(hwnd), button); 

) 

break; 

) /* switch(message) */ 
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Listing 6 continued 


return (DefWindowProc(hwnd,message,wParam,1Param)); 

} 

BOOL ButtonLogic(HWND hwnd){ 

MSG msg; 

RECT rect; 

UINT initial_state; 

TB_DATA ‘button; 

static BOOL overButton; 

button=(TB_DATA *)GetWindowWord(hwnd, 0); 
if((button->state == TBPOS_PUSH) && 
(button->style S TBS_RADI0)) 
return FALSE; 


initial state=button->state; /* Save init state */ 


button->state*TBPOS_PUSH; 
DrawButton(hwnd); 
overButton*TRUE; 
SetCapture(hwnd); 


/* Push the button */ 
/* Draw pushed in */ 
/* Cursor over btn */ 
/* Trap mouse msgs */ 


while(l){ 

if (GetMessage(&msg, NULL, 0, 0)){ 
if(msg.message<WM_MOUSEFIRST || 
msg.message>WM_MOUSELAST) { 
TranslateMessage(&msg); 
DispatchMessage(&msg); 
continue; 

} 


if(msg.message == WM_LBUTTONUP) 
break; 
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if(msg.message *= WM_MOUSEMOVE){ 
GetClientRect(hwnd, &rect); 
if(PtInRect(&rect, MAKEPOINT(msg.lParam))){ 
if(overButton) 
continue; 
overButton=TRUE; 
button->state-TBPOS_PUSH; 

DrawButton(hwnd); 

}else{ 

if(ioverButton) 

continue; 

overButton=FALSE; 

button->state=initial_state; 

DrawButton(hwnd); 

} 

} /* If WM_MOUSEMOVE (the mouse moved) */ 

) /* If we had a message if(GetMessage) */ 

} /* while(l) - Loop until we break; */ 

ReleaseCapture(); /* Free the mouse */ 

if(toverButton) /* Get out if not over button */ 

return FALSE; /* Return no change in state */ 


if(button->style & TBS_RADIO) 
button->state=TBPOS_PUSH; 
else if(button->style & T8S_PUSH) 
button->state=TBPOS_NORM; 
else if(button->style & TBS_TOGGLE) 
if (initial state ■=■= TBPOS_NORM) 
button->state=TBPOS_PUSH; 
else button->state=TBPOS NORM; 


DrawButton(hwnd); /* Draw in new position */ 

return TRUE; /* Return change in state */ 

) 


void DrawButton(HWND hButton){ 


int 

HOC 

RECT 

BITMAP 


offset; 
hdc, hdcMem; 
rect; 
bm; 


HBITMAP hBitmap; 
TB DATA ‘button; 


/* Offset to shift bitmap 
/* DC's for drawing, etc. 

/* To get button size 
/* Bitmap structure 
/* Handle to bitmap to draw 
/* Data for the button 


/ 

/ 

/ 

/ 

/ 

/ 


button=(TB_DATA *) GetWindowWord(hButton, 0); 


/* Load a bitmap for the button we are drawing */ 
if(button->state *« TBPOS_PUSH) 
hBitmap=LoadBitmap(HINST(hButton),button->bmPush); 
if(button->state==TBPOS_NORM || hBitmap==NULL) 
hBitmap=LoadBitmap(HINST(hButton),button->bmNorm); 


/* Get a DC, select bitmap and calculate offset */ 
hdc=GetDC(hButton); 
hdcMem=CreateCompatibleDC(NULL); 

SelectObject(hdcMem, hBitmap); 

GetObject(hBitmap, sizeof(BITMAP),&bm); 
if(button->style & TBS_OWNFX) 
offset=0; 

else offset=(button->state == TBPOS_PUSH) ? 1 : -1; 

/* Draw bitmap and do shading if we need to */ 

BitBlt(hdc, offset, offset, bm.bmWidth, 
bm.bmHeight, hdcMem, 0, 0, SRCCOPY); 
if(!(button->style & TBS_0WNFX)){ 
GetClientRect(hButton, &rect); 
rect.right--; 
rect.bottom--; 


if(button->state ** TBP0S_N0RM) 
SelectObject(hdc, WHITEPEN); 


Page 54 - Windows/DOS Developer’s Journal 


February 1993 















Adding a Floating Toolbar 

This section describes the steps required for adding a float¬ 
ing toolbar to the host application. You must first add to 
host.c a data structure that describes the toolbar you want 
to display. The data structure defines the ordering, look, be¬ 
havior, and the numeric identifier associated with the toolbar 
buttons. Figure 1 shows the static data you should add to 
MainUndProcf). 

The TB_DATA structure (Table 2) is defined in toolbar.h. 
The bmNorm and bmPush fields are pointers to the bitmap 
names used to draw the button face. If bmPush is NULL, the 
bmNorm bitmap will be used to draw the button in both up 
and down positions; the toolbar will shade and shift the bit¬ 
map to simulate the button being pushed. This is the default 
unless you set the TBS_OWNFX bit in the button style. Setting 
TBS_0UNFX makes the bitmaps responsible for their own shad¬ 
ing effects. 


Listing 6 continued 


else SelectObjectfhdc, GRAYPEN); 

MoveTo(hdc, 0, rect.bottom); 

LineTo(hdc, 0, 0); 

LineTo(hdc, rect.right, 0); 

if(button->state == TBP0S_N0RM) 
DeleteObject(SelectObject(hdc, GRAYPEN)); 
else DeleteObject($electObject(hdc, WHITEPEN)); 
LineTo(hdc, rect.right, rect.bottom); 

LineTo(hdc, 0, rect.bottom); 
Delete0bject(SelectObject(hdc, 

GetStockObject(BLACK_PEN))); 

) 

DeleteDC(hdcMem); 

ReleaseDC(hButton, hdc); 

DeleteObject(hBitmap); 

) 

I* Releases previously selected radio buttons */ 
void PopRadioBtns(HWND hwnd, TB_DATA ‘button)( 

FARPR0C lpfnFAR; 

lpfnFAR=MakeProcInstance(EnumButtons, HINST(hwnd)); 
EnumChildWindows(hwnd, lpfnFAR, 

MAKEL0NG(button->hwnd, button->group)); 
FreeProcInstance(lpfnFAR); 

) 

/* Callback function for enumeration procedure */ 

BOOL FAR PASCAL EnumButtons(HWND hwnd, DWORD IParamH 
TB_DATA ‘button; 

if(LOWORD(lParam) ■» hwnd) 

return 1; /* Enumerate next button */ 

button*(TB_DATA *) GetWindowWord(hwnd, 0); 
if(button->group==(int)HIW0RD(lParam) && 
button->state==TBP0S_PUSH){ 
button->state=TBP0S_N0RM; 

DrawButton(hwnd); 

) 

return 1; /* Enumerate next button */ 

) 

/* End of File */ 


The style field selects the type or style of button. The 
TBS_PUSH style button has a momentary action similar to a car 
horn or door bell. The TBS_RADIO style provides radio button 


Table 2 The TB_DATA structure 

Field 

Description 

char 'bmNorm 

Name of bitmap for normal (out) 
button. 

char 'bmPush 

Name of bitmap for pushed button. 

style 

Button style (Push, Radio or Toggle). 

msg_id 

Message ID sent when button is 
pressed. 

state 

Initial state of button. 

group 

Used to group radio buttons 
(TBS_ RADIO) 

hwnd 

Button handle. Initialize to NULL. 


Figure 1 Floating toolbar definition 


static HWND hToolbar; /* Handle to the Toolbar window */ 
/* Toolbar description data. */ 
static TB_DATA toolbar[] = { 

"RED", NULL, TBS_RADI0, IDM_RED, TBP0S PUSH, l.NULL, 
"GREEN",NULL, TBS_RADI0, IDM_GREEN,TBP0S_N0RM, l.NULL, 
"BLUE", NULL, TBS_RADI0, IDM_BLUE, TBPOSJORM, l.NULL, 
NULL, NULL, TBS ESCAPE,TB_NEXT_R0W, 0, 0, NULL, 
"REG", "INV", TBS~T0GGLE,IDM_INV7 TBPOSJORM, 0.NULL, 
"CLS", NULL, TBS_PUSH, IDM_CLEAR,TBP0S NORM, 0.NULL, 
"DING","DONG",TBS_PUSH, IDM_BEEP, TBPOSJORM, 0.NULL, 
NULL, NULL, TBS_ESCAPE,TB MOVE, 0, -32, NULL, 

"AB0UT_0UT“, "AB0UT_IN\ TBSJWNFX | TBSJUSH, IDMJ80UT, 
TBPOSJORM, 0, NULL); 


Figure 2 Code to create the floating toolbar 


case IDM_TB_SH0W: /* Show the toolbar */ 

if(hToolbar==NULL)( 

hToolbar=CreateToolBar(hwnd, TBSTYLE_FLOAT); 
SetProp(hToolbar, (LPSTR)"NOTIFY", hwnd); 
SendMessage(hToolbar,TBM_INITIALIZE,(WPARAM)&toolbar, 
(LPARAM) (sizeof (toolbar)/sizeof(TBJATA))); 
ShowWindow(hToolbar, SW_SH0W); 

) 

else DestroyWindow(hToolbar); /* Toolbar already exists */ 

return 0; 


Figure 3 Updating the toolbar buttons 


case WM_C0MMAND: (<* Already coded) 

/“* Add the following two lines of code “*/ 
if(hToolbar && L0W0RD(1Param)==0) 

SendMessage(hToolbar, TBMJENUPICKED, wParam, 0L); 
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functionality. The group field determines the grouping of the 
radio buttons. The buttons within a TBS_RADIO group are 
mutually exclusive (only one can be selected at a time). If you 
are using more than one set of TBS_RADI0 buttons per toolbar 


Figure 4 Updating the initial menu 


case WMJNITMENU: 
if(hToolbar){ 

CheckMenuItem(GetMenu(hwnd),IDM TB_SHOW,MF_CHECKED); 
SendMessage(hToolbar, TBMJETMYMENU, GetMenu(hwnd) ,0L); 

) 

else CheckMenuItem(GetMenu(hwnd), IDM_TB_SHOW, MF_UNCHECKED); 
break; 


Figure 5 Fixed toolbar definition 


static TB_DATA tool bar [] = { 

NULL, NULL, TBS_ESCAPE, TB_M0VE, 15, 4, NULL, 
"RED”, NULL, TBS RADIO, IDM_RED, TBPOS_PUSH, l.NULL, 
"GREEN",NULL, TBS~RADI0, IDM_GREEN,TBPOS_NORM, l.NULL, 
"BLUE", NULL, TBS_RADI0, IDM_BLUE, TBP0S_N0RM, l.NULL, 
NULL, NULL, TBS_ESCAPE,TB_MOVE, 15, 0, NULL, 
"REG", ”INV\ TBS'TOGGLE,IDM_INV, TBPOS NORM, O.NULL, 
"CLS", NULL, TBS_PUSH, IDM_CLEAR,TBP0S_N0RM, O.NULL, 
NULL, NULL, TBS_ESCAPE,TB_MOVE, 15, 0, NULL, 
"DING","DONG",TBS PUSH, IDM_BEEP, TBP0S_N0RM,0, NULL); 
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then assign a unique group number to each set. TBSJT0GGLE 
style buttons toggle on and off. Pressing the button once 
selects it and pressing it a second time cancels it. You can 
combine the TBS_0UNFX style bit with any of the button 
styles. 

The TBS_ESCAPE style is used for special functions. Two es¬ 
capes are currently provided. If msg_ID is set to TB_NEXT_R0U, 
then the next button will start a new row. Setting msg_ID to 
TB_M0VE will manually offset the position of all subsequent 
buttons. The state and msg_ID fields determine the X and Y 
offsets respectively. Button positions are calculated automat¬ 
ically and can be overridden with TBS_ESCAPE commands. 

The state field determines the initial position of a button, 
which can be either TBP0S_PUSH or TBP0S_N0RM. The group 
field separates different sets of TBS_RADI0 buttons. The hwnd 
field is used by the toolbar to store the button handle. Initial¬ 
ize this field to NULL. 

After adding the data structure that defines the toolbar, 
you can add the code (see Figure 2) that creates the toolbar 
when the user selects the appropriate menu item. 

CreateToolBor() creates but does not display a toolbar. 
hToolbar is the toolbar handle, which is just another window 
handle. Setting the "NOTIFY” property using SetPropO deter¬ 
mines which window will receive toolbar notification mes¬ 
sages. Sending a TBM_INITIALIZE message passes the address 
of the TB_DATA structure used to construct the toolbar. Once 
the structure is initialized, ShowUindowf) is called to display 
the toolbar. 

When a toolbar is destroyed, the window handle stored in 
the "NOTIFY” property will receive a TBM_DESTR0YED message 
with wPa ram set to the toolbar handle. Add the following code 
to respond to this message: 

case TBM_DESTR0YED: 

iffwParam == hToolbar) 

hToolbar=NULL; 

return 0; 

You can now compile and run the host program to see the 
floating toolbar. Selecting Toolbar-Show from the menu dis¬ 
plays a floating tool palette that simulates menu commands 
from the host window. One small problem remains, since 
selecting new text colors from the menu does not update the 
buttons in the toolbar. You can fix this problem by altering 
the UM_C0MMAND message processing code as shown in Figure 
3. This sends a message to the toolbar when a menu item is 
chosen. Menu items not found in the toolbar are ignored. The 
toolbar can be used to help manage the menu by adding the 
code in Figure 4. UM_INITMENU is received before a menu is 
shown. The toolbar procedure checks menu items which are 
selected (pushed in) and unchecks items which are not 
selected. This will work only with menu items which are 
present in the toolbar. 

Fixed Toolbars 

The floating toolbar is now 100 percent functional and 
complete. Changing the floating toolbar to a fixed toolbar is 
relatively easy. A few lines of code must be changed and the 
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toolbar must be able to respond to the host window's being 
moved or sized. 

The first step is to change the toolbar description [TB_DA TA) 
to display the bitmaps in a single row: Figure 5 shows the 
new definition. Notice that the About item has been removed 
(it was too tall) and the Escape-Move command is used to 
create a small border above the buttons and to add space 
between button groups. 

The IDM_TB_SHOW case, which creates the toolbar, also 
must be modified: the new code is shown in Figure 6. The 
parameter to CreateToolbarf) has been changed from 
TB_FL0AT to TB_FIXED. Force the height of the toolbar to be a 
little taller than the 32-pixel bitmaps by calling SetPropfh- 
Toolbar, “TALL",40). 

Calling DrawMenuBarO forces Windows to recalculate a 
window’s size and position regardless of whether it has a 
menu or not. This generates several messages, including 
UM_NCCALCSIZE, which is handled as shown in Figure 7. This 
lets Windows think the host window is shorter than it actually 
is. Windows compensates by making the client area shorter, 
so the toolbar can occupy a non-client area of the window. 

Last, the toolbar needs to stay sized and positioned rela¬ 
tive to the host window. Move the toolbar whenever the host 
window is moved by intercepting the UM_SIZE and UM_MOVE 
messages, as shown in Figure 8. 

Conclusion 

There is still plenty of room for improving the toolbar. The 
code as implemented will work only with the small or 
medium memory model ( near data pointer). The code can 
also be enhanced to support ■'grayed” or disabled buttons and 
to prevent the fixed toolbar from receiving the focus. 


Figure 6 Creating the fixed toolbar 


case IDM_TB_SHOW: /* Show the toolbar */ 

if(hToolbar==NULL)( 

hToolbar=CreateToolBar(hwnd, TBSTYLE_FIXED); 
SetProp(hToolbar, (LPSTR)"NOTIFY", hwnd); 
SetProp(hToolbar, (LPSTR)"TALL", 40); 
SendMessage(hToolbar, TBM_INITIALIZE,(WPARAM)&toolbar, 
(LPARAM)(sizeof(toolbar)/sizeof(TB_DATA))); 
DrawMenuBar(hwnd); /* Re-Calculates window size */ 
ShowWindow(hToolbar, SW_SH0W); 

) 

elsef 

DestroyWindow(hToolbar); /* Toolbar already exists */ 
DrawMenuBar(hwnd); /* Reclaim screen area */ 

) 

return 0; 


Figure 7 Allocating window space for the fixed 
toolbar 


RECT far *fpRect; /* fpRect must be declared as this */ 

case WM_NCCALCSIZE: 
iffhToolbar && !IsIconic(hwnd))( 
fpRect*(RECT far *)lParam; 
fpRect->top+*GetProp(hToolbar,"TALL"); 

) 

break; 


Since this is just a demonstration rather than a real pro¬ 
gram, my emphasis was on clarity rather than functionality. In 
real life, you should create the toolbar during UM_CREATE and 
never destroy it. Hide the toolbar window whenever the user 
doesn’t want it visible. This allows the toolbar to stay 
synchronized with the selected color and text attributes. This 
also means that the toolbar, visible or not, can help manage 
the menu and that the “ iffhToolbar)’ checks for a valid tool¬ 
bar handle now become unnecessary. 

Toolbars can be added to existing code with little effort 
and only a few modifications. If you try it, you will find that 
the hardest part of adding a toolbar is drawing those little 
bitmaps. □ 


Figure 8 Maintaining fixed toolbar size and position 


case WM_SIZE: /* Host window is being sized */ 
if(hToolbar) 

SetWindowPos(hToolbar,0,0,0,LOWORD(lParam), 
min(GetProp(hToolbar,"TALL").HIWORD(lParam)), 
SWP_N0M0VE I SWP_N0Z0RDER | SWP_NOACTIVATE); 
break; 

case WM_M0VE: /* Host window is being moved */ 
if(hToolbar) 

SetWindowPos(hToolbar, 0, LOWORD(lParam), 

HIWORD(lParam)-GetProp(hTool bar,"TALL"),0,0, 
SWP_N0SIZE I SWP_N0Z0RDER | SWP_N0ACTIVATE); 
break; 
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Windows, DOS, and ... 
Foot Pedals? 


Fine-tuning Notepad for Program Listings 


Michael Soflin 
M.R. Software 
1410 Harris Road, Suite C 
Lakeport, Ml 48059 

I like to use Notepad in conjunction with File Manager to perform simple edits 
that don't require a word processor or a program editor. However, I browse many C 
listings that have the tab stops set at four spaces. These files come up with 
notepad's default tab spacing of eight. The fact that Notepad appears in a different 
position each time is also troublesome. Ideally, I want Notepad to come up maxi¬ 
mized, with the tab stops set at four characters. 

Included is a short Windows program that I wrote to address this problem. Per¬ 
haps some of the techniques would be of use to your readers. The algorithm is 
straightforward: 

1. Launch Notepad as a hidden window. 

2. Locate the main edit control for the notepad that was just launched. 

3. Adjust the tab stops. 

4. Show the notepad in a maximized state. 

In File Manager, I associate the types of files that I want to browse with the new 
note program. What I see come up is a maximized notepad with tab stops set at 
four. 



Leor Zolman wrote BDS C, the first C compiler targeted exclusively for personal com¬ 
puters. Leor is currently an instructor on UNIX topics for Boston University's Corporate 
Education Center, a regular contributor to The C Users Journal and Sys Admin 
magazines, and ‘Tech Tips" editor for Windows/DOS Developer’s Journal. His /irst book, 
Illustrated C , was recently published by R&D Publications, Inc. He may be contacted 
at 74 Marblehead St., North Reading, MA 01864, or on Usenet/Internet as-. 
leor@bdsoft.com. 
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This technique works well for simple edits. Some opera¬ 
tions within Notepad (such as setting word wrap) will cause 
Notepad to revert to its default of eight-character tab stops. I 
generally do not make these types of changes while browsing 
from File Manager. 

The program was written using Borland C++ 3.1 and can be 
compiled and linked by executing: 

bcc -WE note.c 

Listing 1 is note.c, and Listing 2 is note.def. 

Simple Debugging under Windows 


David Vickmark 
RR-2 BOX 34 
Ramona, SD 5704-9531 


A quick way to debug DOS (or any other character-based) 
programs is to use a print statement to display the values of 
variables to the screen. Under Windows, text output isn't 
quite as simple, but you can imitate this debugging technique 
by using the MessageBoxf) function: 



descriptive string as IpszTitle. MB_0K should be the fuStyle 
for a simple box with a single “OK" button. 

If the variable you want to check is numeric, you must first 
use a conversion function to create an ASCII representation of 
the value, then pass that string as the IpszText parameter 
instead of the actual numeric value. 

For example, to display the value of an integer variable 
named val: 

char temp_str[50]; /* temporary buffer */ 

itoa(temp_str, val, 10); /* convert integer to string */ 
MessageBox(HWindow, /* do it */ 

temp_str, “Value of val“, MB_0K); 

HUindow holds the handle of the window when using 
Borland's Object Windows library (OWL). If you're not using 
OWL, you can just use NULL. The message box code, however, 
remains the same. 

When your code executes the MessageBoxf) call, a win¬ 
dow will appear on the screen with your description as the 
title, the value being checked in the middle, and an OK but¬ 
ton. Pressing the Enter key or clicking on the button will clear 
the window and your program will resume execution. 

If you suspect a section of code isn’t being executed, using 
a message box to check is even easier: 


int MessageBox(hwndParent, IpszText, IpszTitle, 
fuStyle) 

HWNO hwndParent; /* handle of parent window */ 

LPCSTR IpsztEXT; /* address of text in message box */ 
LPCSTR IpszTitle; /* address of title of message box */ 
UINT fuStyle; /* style of message box * 

Simply supply a window handle as hmdParent, a pointer to 
the string variable you wish to see as IpszText, and a 


MessageBox(HWindow, “I'm here!", “Lost Code", MB_0K); 

Now if you get a message box on the screen, your code ex¬ 
ecuted. Otherwise, it's back to the old flowchart. 

This technique won’t take the place of a good debugger, 
but sometimes it is quicker to insert a MessageBoxf) call than 
it is to load the debugger and set breakpoints and step 
through your code. The MessageBoxf) call won't cause as 
many unpleasant side effects as debuggers sometimes do. 









Computing Total Allocated File Space 


Dan Goldberg 
140 E. Hartsdale Ave #5L 
Hartsdale, NY 10530 


As a consultant I am often called upon to solve tricky 
problems. For the sake of expediency, I frequently use techni¬ 
ques that are unorthodox. The enclosed C program is an ex¬ 
ample of one. 

I had to write a program, to be used for billing purposes, 
that would get a directory name, count the number of files, 


the size of each file, and the total amount of disk space ac¬ 
tually consumed by the Files. Finding out the total amount of 
disk space (the allocated space) was the tricky part 
After some figuring, I came up with this formula: 

Allocated File Space = (individual file size/Block Size) + 1 
multiplied by the block size. 

For example, if the individual file size were 8194, and the 
block size were 4096, the result of the division would be 2, 
plus a small fraction representing the number of bits into the 
next sector that the file occupies. Since DOS reserves the 
whole cluster if the file uses any part of it, you must add 1 to 


Listing 1 note.c 


lindude <windows.h> 


#indude <string.h> 

// Execute notepad but hide the window 
wsprintf (sz, "notepad.exe %s", lp); 

Idefine STRICT 

BOOL CALLBACK FindThisNotePad ( 

h = WinExec (sz, SWHIDE); 
if (h < 32) return TFALSE); 

HWND hwnd, 

// Find the current notepad 

LPARAM IParam) 

hwndNote = NULL; 

// . 

EnumWindows ((WNDENUMPR0C) FindThisNotePad, 

// Look for a particular instance of notepad 

MAKEL0NG (h, &hwndNote)); 

// . 

{ 

if (GetWindowWord (hwnd, GWW HINSTANCE) 

if (hwndNote =« NULL) return (FALSE); 

// Find the main edit control of current notepad 

== L0W0RD (IParam)) 

hwndEdit = NULL; 

{ 

EnumChildWindows (hwndNote, (WNDENUMPR0C) FindEdit, 

*((HWND *) HIW0RD (IParam)) = hwnd; 

MAKEL0NG (0, &hwndEdit)); 

return (0); 

) 

return (1); 

if (hwndEdit ■■ NULL) return (FALSE); 

// Change the tab stops to 4 spaces instead of 8 

) 

hdc = GetDC (hwndEdit); 

GetTextMetrics (hdc, &tm); 

BOOL CALLBACK FindEdit ( 

ReleaseDC (hwndEdit, hdc); 

HWND hwnd, 

iTab = (tm.tmAveCharWidth * 16) / 

LPARAM IParam) 

L0W0RD (GetDialogBaseUnits ()); 

// . 

SendMessage (hwndEdit, EM SETTABST0PS, 1, 

// Look for the edit control of notepad 
// . 

(LPARAM) Tint far *) &iTab) ; 

f 

// Show the window maximized 

char sz [80] ; 

ShowWindow (hwndNote, SW_SH0WMAXIMIZED) ; 
return (TRUE); 

GetClassName (hwnd, sz, sizeof (sz)); 
if (strcmp (sz, “Edit") == 0) 

) 

1 

Ipragma argsused 

*( (HWND *) HIW0RD (IParam)) = hwnd; 

int PASCAL WinMain ( 

return (0); 

HINSTANCE hlnstance. 

) 

HINSTANCE hPrevInstance, 

return (1); 

LPSTR lpCmdLine, 

) 

int nCmdShow) 

// . 

BOOL Note ( 

// Main program. Call the new note function. 

LPSTR lp) 

// Use a beep to show an error condition. 

// . 

//. 

// Launch the notepad and configure 

{ 

//.-. 

if (INote (lpCmdLine)) MessageBeep (0); 

{ 

return (0); 

int iTab; 

) 

TEXTMETRIC tm; 

HDC hdc; 

HINSTANCE h; 

char sz [80]; 

HWND hwndEdit, 

hwndNote; 

/* End of File */ 
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the result of the individual filesize / block size to ensure 
that the extra cluster gets counted. 

But what do you do in cases where, for example, the file 
size is an exact multiple of the block size (including a zero- 
length file)? These files are a special case: their allocation size 
is equal to their “conventional” size. 

The program to perform these calculations is fcount.c 
(Listing 3). If run with no arguments, / count reports its findings 
to the console. When run with the -f option, / count appends 
the information, in an ASCII database-compatible format (a 
one-line record, fields delimited by the vertical bar character), 
to the file \FILESIZE.DAT in the root of the currently logged 
drive. I used a little trick here: the / reopen() function 
redirects standard output into the desired disk file. 

To get the block (or “cluster”) size for the host system, the 
program uses get_bsize() to read the block size out of the 
local FAT (file allocation table). 

Adding Foot Pedals to Your Keyboard 


Homer Tilton 
8401 Desert Steppes Dr. 
Tucson, AZ 85710 


You can add a satellite keypad to your PC by a simple 
hardware change if you know how to use a 25-watt pencil 
soldering iron around modern electronic hardware. You can 
add two foot pedals for a total cost of about $5 for connectors 
and switches, plus some scraps from the junk box. No chips 
needed. And no, you need not ruin a perfectly good keyboard 
in the process! 

All the keys on the normal manual keyboard remain ac¬ 
tive, and the presence or absence of the satellite keypad 
makes no difference to the operation of the normal keyboard. 
Maybe best of all, there is no RAM-resident software to inter¬ 
fere with your must-have TSRsI 

I have modified two manufacturers’ keyboards for two- 
pedal use: a Keytronic Model E03435 and a Honeywell Model 
101 RXe. 

In Keytronic Corporation’s Model E03435, each keypress 
shorts together two lines on a 24-conductor printed cable in¬ 
side the keyboard. By bringing wires out from those lines, you 
can effectively actuate any key by means of an external 
momentary-contact switch. By shorting lines 1 and 24, the ef¬ 
fect is the same as pushing the left Al t key. And by shorting 
lines 3 and 9, the effect is the same as pushing the left Ctrl 
key. If you bring all 24 lines out to an external connector, 
you'll have complete flexibility. 

The table that tells which two lines to short together for 
each key is called a "keyboard map.” Table i shows the com¬ 
plete keyboard map for the Keytronic E03435. 

A similar plan holds for the Honeywell Model 101 RXe, but 
the keyboard map is different. There are two printed cables, 
one with 14 lines and one with 16. Left Ctrl and left Alt 
keys map into lines 1,5 and 1,6, respectively. The first number 
of each number pair refers to the internal 14-line printed 
cable and the second to the 16-line cable. Numbering is from 



Listing 2 note.def 


NAME 

note 

DESCRIPTION 

'Microsoft Windows Application' 

EXETYPE 

WINDOWS 

STUB 

'WINSTUB.EXE' 

CODE PRELOAD MOVEABLE DISCARDABLE 

DATA PRELOAD MOVEABLE MULTIPLE 

HEAPSIZE 

1024 

STACKSIZE 

5120 


left to right looking at the keyboard in its normal orientation. 
You'll need to bring out 30 lines to have complete flexibility in 
this case (actually only 29, since one line isn’t used). Table 2 
shows the complete keyboard map for the Honeywell. 

Ease off the Keytronic keyboard cover by gently poking a 
screwdriver blade into the slots in the bottom to disengage 
the plastic catches. Find the 24-line flexible printed cable going 
from the key switches to the printed circuit card. You’ll need 
to bring four connections out from that cable —one each from 
lines 1, 3, 9, and 24. Carefully spot-solder a #26 or #28 
stranded wire to each of those lines. If you have a 10-inch 
length of four-wire ribbon cable, that will be ideal. 



I 

pul 

Cl 

w 

• 4k. 


Do you need WYSIWYG Text Processing in 
your Windows Application? No Problem! 


Tabulator 

types: 

left 

right 

centered 

decimal 


Font 

attributes: 

bold 

italic 

underline 

s tr i keout 

su P er cr , r int 


Paragraph 

alignment: 

left 

centered 

right 

justified 


- for all printer fonts I 


Just use the TX Text-Control DLL to integrate features 
like multiple fonts, paragraph formatting, zooming or 
tabs. Even pictures can be included with an additional 
tool, the 1C Image-Control. 

Get your free demo today! 

Call 203-521-0881 (USA or Canada) 

The Aristos Company, 181 Loomis Dr. Suite 146 
West Hartford, CT 06107, Phone 203-521-0881 
Fax 203-561-2045, CompuServe 73020,2101 

Elsewhere contact 
DBS GmbH, FahrenheitstraBe 1 
2800 Bremen 33, Germany 
Phone +49 421 /22 08-162 
Fax +49 421 / 22 08-273 
CompuServe: 100013,115 

Windows is a trademark of Microsoft Corporation 
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ABSOLUTELY, 
POSITIVELY, 
NO MORE 

vIs t iHq. 

E"rOR S / 


HOW? 

Simple. The 
Windows/DOS 
Developer’s Journal 
magazine 
code listings 
are ALREADY 
on disk. Don’t waste 
your time typing in 
listings! 


$5/disk, 
one issue 
per disk, 
or ALL of 
1991 
or 1990 
for $20! 


Call today! 

913 - 841-1631 

FAX 

913 - 841-2624 


Windows/DOS 


□ developer's journal 

Suite 200 

1601 West 23rd Street 
Lawrence, KS 66046 


For the Honeywell keyboard, bring 
connections out from line 1 of the 14- 
line cable, and from lines 5 and 6 of the 
16-line cable. 

For both keyboards, bring the con¬ 
nections out to a 5-pin DIN female con¬ 
nector, the same type of connector 
used on the normal keyboard cable but 
of opposite gender. For the keytronic, 
connect lines 1, 3, 9, and 24 to pins 5, 2, 
4, and 1, respectively. For the 
Honeywell, connect lines 5 and 6 to 
pins 4 and 5, respectively, and connect 
line 1 to pins 1 and 2. Look for the 
raised pin numbers on the headers, as 
they are not in sequence. 


When pins 1 and 5 of the DIN con¬ 
nector are shorted together (by switch 
closure), that's like pushing the left Alt 
key on the manual keyboard; when 
pins 2 and 4 are shorted together, 
that’s like pushing the left Ctrl key. 
This is true for both keyboards. 

You can buy two foot switches 
(Model T-51-S) from Linemaster Switch 
Corporation for $ 18.40. Or you can buy 
their dual model, Model TWIN T-51-S for 
$28.40. But they have a $ 100 minimum 
orderl Their address is Box 238, 
Woodstock, CT 06281, phone 203-974- 
1000. 

Or you can do what I did: buy two 
momentary-contact push-button 


Listing 3 fcount.c 


/* 

* 

* fcount.c 

★ 

* Written by Dan Goldberg, 1992. 

* Modified by Leor Zolman, 12/92. 

* 

* Usage: fcount [-f] 

* 

* Gets directory name, number of files, dos filesize total, and 

* allocation filesize total (computed using a formula). 

* 

* Displays info on screen by default. If -f specified, also appends 

* the info as a (-delimited data record to the file \FILESIZE.DAT 

* on the current drive. 

* 

* General formula for total disk space allocated to a file: 

* Total Allocation Size = ( int(FileSize/Blocksize) + 1) * Blocksize 

* (unless the Filesize is an even multiple of the Blocksize, 

* in which case the total allocation size is simply the Filesize) 

* 

* Compile (Turbo/Borland C/C++): 

* bcc fcount.c 
*/ 


linclude <stdio.h> 
linclude <dos.h> 
linclude <dir.h> 
linclude <string.h> 

Idefine DISKFILE "\\FILESIZE.DAT" 


long get_bsize(void); 


int main(int argc, char **argv) 
{ 


int write_file = 0; 
int count « 0; 

int blocksize = get_bsize(); 
unsigned long total size » 0; 
unsigned long tallocsize = 0; 
unsigned long filesize; 
char pathname{81]; /* 

struct ffblk fileinfo; 


/* Set to 1 if -f option given */ 
/* file count */ 
/* allocation chunk (block) size*/ 
/* sum of actual file sizes */ 
/* sum of allocation sizes */ 
/* size of file being processed */ 
ir array to hold directory path */ 


if (argc == 2 && !strcmp(argv[l], “-f“)) 
write_file = 1; 

if( findfirst(”*.*“, ifileinfo, 0) *« -1) 
( 

printf("Empty Directory!\n"); 
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switches from Radio Shack at two for 
$1.79 plus tax. Mount these vertically 
on a 9x12-inch scrap of 1/2-inch 
plywood (the “floorboard”) via two 
brackets made from one-inch lengths of 
ixl-inch aluminum channel. Mount 
them along the toe edge (long dimen¬ 
sion) of the floorboard at the 1/4 and 
3/4 points so that one can be operated 
with your left foot, the other with your 
right foot Using a four-wire, four-foot 
cable with #20 to #24 conductors, wire 
the left switch to pins 2 and 4 of a 
male DIN connector, the right one to 
pins 1 and 5. 

Add pedals to depress the switch 
buttons. These can be simply 4x9-inch 


pieces of 1/2-inch plywood fastened to 
the floorboard with cabinet hinges at 
their heel ends. Better yet, arrange to 
hinge the pedals at their centers. In 
that way, pressure on the toe actuates 
the switch, but pressure on the heel 
does not. 

Keyboard manufacturers may be 
missing a money-making bet by not 
bringing out connections as described. 
Think of the many varieties of satellite 
keypads that they could then market to 
go with their keyboard. There could be: 

• Dual keyboards for training — like 
dual car controls for driver training 

• A separate telephone number pad 
with numbers running 


Listing 3 continued 


getcwd(pathname,80); 
count ■ 0; 

) 

else 

do 

( 

count++; 

getcwd(pathname,80); 

filesize * fileinfo.ff_fsize; /* actual bytes in the file */ 
total size +* filesize; /* running total of above */ 

if (!(fi1esize % blocksize)) 
tallocsize +■ filesize; 

else 

tallocsize +« ((filesize / blocksize) + 1 ) * blocksize; 

) 

while(f1ndnext(&fileinfo) ■■ 0); 

printf("%s: %d files, %ld bytes data, %ld bytes allocated.\n“, 
pathname, count, totalsize, tallocsize ); 

if (write file) 

( 

/* redirect output to file in append mode */ 
freopen(DI$KFILE, ”a+b\ stdout); 
printf("|\”%s\"|\"%d\"|\"%ld\ H |\ M %1d\"|\n“, 

pathname, count, totalsize, tallocsize ); 
fclose(stdout); 

) 

return 0; 


/* BLKSZ.C: standard FAT manipulation routines. 

Look in any of the C 'bibles' - DEG */ 

long get bsize() 

< 

struct fatinfo fat; 
unsigned char fatid; 
long block_size; 

getfat(0, &fat); 

return (long)fat.fi_sclus * (long)fat.fi_bysec; 


/* End of File */ 
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THE Audio Solutio 

So you've 
decided to 
add music & 
sound to your 
DOS product? 

Option A: 

Purchase 20 
sound boards and 
20 sets of technical 
documentation. 

Spend 2 years 
engineering 
digital sound and 
MIDI music drivers. 

All for a total cost 
greater than $85,000! 


Option B: 

Purchase The Audio 
Solution's MidPak and 
DigPak for all of your 
digital sound and MIDI 
music needs. 


For less than 
S220! 


Plus a reasonable 
license fee when you 
distribute our drivers. 

It's no wonder that 
MidPak and DigPak 
are the standard of the 
Computer Game 
Industry! 


sound blaster covox adlib 
media vision roland 
pro audio spectrum 
asc media master 
digispeech lantastic 
disney sound source 
IBM internal echo II 


THE Audio Solution 

314-567-0267 
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1 23/456/789/*0# instead of 
789/456/123/00 as they do on the 
existing numeric keypad 

• Foot pedals for whatever purpose — 
like a pipe organ 

• A piano style keyboard; etc. 

Such satellite keypads need contain 
only switches — no chips, no software. 
You simply plug in the one you’ve 
chosen to the new connector on your 
regular keyboard. 


Note.- This tip was spurred by the 
unwelcome intrusion into the 
typewriter-keys area of the four Ctrl 
and Alt keys on the 101-key keyboard. 
I thought: “How about foot pedals?" 

You can purchase a single foot pedal 
to connect to your parallel port. That, 
with the necessary software, costs about 
$60 from Brown & Co.lnc, Box 861, Geor¬ 
getown, MA 01833, (508) 352-8822. 

But I wanted two pedals. One thing 
led to another... □ 


Table 1 Keytronic Model E03435 keyboard map 



09 

10 

11 

12 

13 

14 

15 

16 

17 

18 

19 

20 

21 

22 

23 

24 

1 



Esc 


F4 

G 

F5 

H 

F6 


1 U 


0NK 

• NK 

Up 

L/A 

2 


L/S 

Tab 

C/L 

F3 

T 

BS 

Y 

] 

F7 

[ 

4NK 

5NK 

6NK 



3 

L/C 


<v 1 

FI 

F2 

5% 

F9 

6* 

»+ 

F8 

- 

Del 

Ins 

P/U 

Horn 


4 



11 

2@ 

3# 

4$ 

F10 

78. 

8* 

9( 

0) 

Fll 

F12 

P/D 

End 

P/S 

5 



Q 

W 

E 

R 


U 

I 

0 

p 

7NK 

8NK 

9NK 

+NK 

S/L 

6 



A 

S 

D 

F 

\| 

J 

K 

L 

• • 

INK 

2NK 

3NK 

ENK 


7 

R/C 

R/S 

Z 

X 

C 

V 

Ent 

M 

.< 

.> 


N/L 

/NK 

*NK 

P/B 


8 






B 

Spc 

N 



/? 

Dn 

Rt 

-NK 

Lt 

R/A 


KEY: 

P/B 

BS 

P/U 

N/L 

NK 

P/D 

L/S 

R/S 

L/C 

L/A 

P/S 

Up 

Dn 


Pause/Break 
Back space 
Page up 
NumLock 

Numeric keypad 
PageDown 
Left Shift 
Right Shift 
Left Ctrl 
Left Alt 
Print Screen 
Up arrow 
Down arrow 


Example of use: K key is at lines 6 and 17 
on 24-conductor printed cable. 
Short line 6 to line 17 to 
effectively actuate the K key. 


C/L 

ENK 

R/C 

R/A 

S/L 

Lt 

Rt 


CapsLock 
Enter (NK) 
Right Ctrl 
Right Alt 
Scroll Lock 
Left arrow 
Right arrow 


Table 2 

Honeywell Model lOIRXe keyboard map 




1 2 

3 4 

5 6 7 8 

9 10 

11 

12 

13 

14 

15 16 
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C/L L/S 

L/C L/A R/A 

R/C R/S 






2 

ESC 


Spc 




Lt 

Rt 

0NK .NK 

3 
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z 

M 


f < 


Ent 

Dn 


4 

TAB 

X 

N 





Up 

INK ENK 

5 

A 

c 

B 


.> 


/? 


2NK 3NK 

6 

S 

V 

J 


i • 


1 II 


4NK 

7 

Q 

D 

H 


K 


Del 

End 

5NK 6NK 

8 

1! 

F 

G 


L 



P/D 

8NK 9NK 

9 

20 

R 

I 


]} 


[( 

P/U 

7NK +NK 

10 

W 

E 

Y 


P 


BS 

Horn 

N/L -NK 

11 

3# 

T 

U 


0 


\| 

Ins 

/NK *NK 

12 

4$ 

5% 

6~ 


* + 



P/s 

S/L P/B 

13 

FI 

F3 

7& 


0) 


F12 

Fll 

F10 F9 

14 

F2 

F4 

8* 


9( 


F5 

F6 

F7 F8 




Example 

if use: 

K key is 

at 

line 

7 of the 14- 





conductor cable 

and 

line 11 of 





the 

16- 

conductor cable. 

See 

Table 1 

for key. 
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Instancing a DLL’s DGROUP 


Q ln Windows 3.1, is it possible to instantiate the DGROUP of a DLL more than 
once? That is, if multiple applications link to a DLL, can the DGROUP or a par¬ 
ticular DATA segment be instantiated once per application? The Environment and 
Tools C/C++ 7.00 manual, at page 621, says that the MULTIPLE keyword in the .def 
file is the default for applications, and that SINGLE is the default for DLLs. When I link 
the DLL with DATA MULTIPLE, the linker doesn’t complain, but when my first applica¬ 
tion tries to link to the DLL, DBWIN shows that LoadLibraryQ fails with error 6, that 
is, “Library required separate data segments for each task.” If I use exehdr -v on 
system DLLs, I can see that the DATA segments are always shared. So I think that 
the answer to my question is no. 

I have been thinking of the following solution: 

For each task that links to the DLL, an init() routine could allocate memory, 
copy into it the contents of the DGROUP segment of the DLL (it should be concep¬ 
tually read-only), create a selector that points to this memory, and maintain a table 
that relates the hTasks with the selectors. Each exported routine of the DLL, on 
entry, should map the hTask to its own selector. 

Could this solve my problem? Does it make sense to you? Is this good Windows 
programming practice? 

The problem is that I have a library that already exists in VMS and Ultrix. In VMS 
it is a shareable library with per-task data-, in Ultrix, a normal .a library (but without 
the advantages of dynamic linking). For the Windows version I would like the 
benefits of the dynamic link mechanism without having to heavily modify code that 
already runs. As it stands now, only one task can use my DLL at a given time. 

Stefano Corgnati 
Sesam SpA 
Corso Svizzera 185 
10149 Torino 
Italy 


Paul Bonneau 


Send questions to Paul via Internet 
as paul@rdpub.com-, 
from CompuServe: 
>INTERNET:paul@rdpub. com-, 
or in care of this magazine at: 

1601 W. 23rd St., Suite 200 
Lawrence, KS 66046-2743. 


Editor's Note 

To make sure that his column is not interpreted as representing Microsoft 
Corporation, Microsoft Legal has requested that Paul Bonneau not list 
Microsoft as his employer. Hereafter, his biographical data will appear as 
below. 

It is not our intention to hide the fact that Paul works at Microsoft or to 
obscure some connection between this magazine and Microsoft: we have no 
relationship with Microsoft. Our goal is to bring you the best technical infor¬ 
mation possible, and we believe (many of you agree) that Paul has supplied 
some of the best technical information on Windows available anywhere. We 
take this step to ensure that he will be able to continue to do so. 


Paul Bonneau is a Senior Software Design Engineer at a major software firm. He was 
a developer of HyperChem, a molecular modeling system marketed by Autodesk. 


















A Well, to start with, you are correct about a DLL’s being 
able to possess only one DGROUP. Both DLLs and ex¬ 
ecutable programs are examples of modules. There can be 
more than one instance of a program (each instance is a task 


and is identified by the task handle), each with its own unique 
copy of DGROUP. All instances of a particular program com¬ 
prise a single module. Since there is only one copy of the 
code per module, a program module is essentially a single 


Listing 1 insdii.c 


/*****************************************************/ 

UINT wSelClient; /* Client's copy of DS. */ 

/* insdll.c */ 

HGLOBAL hgblThis; /* DLL's DGROUP. */ 

/* — DLL that maintains a separate DGROUP for each */ 

DWORD cb; /* Size of DGROUP. */ 

/* client task. */ 

/★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★Hr****************/ 

LPCDS lpcds; /* Client's data struct. */ 

if (LpcdsFindCurTaskO) 

linclude <windows.h> 
linclude <windowsx.h> 

return FALSE; /* Already registered. */ 

♦include <memory.h> 

/* Clone our DGROUP and add the current client */ 

linclude "insdll.h" 

/* task to the array. */ 
asm mov wSelThis, ds; 

typedef struct 

hgblThis » (HGLOBAL)LOWORD(GlobalHandle(wSelThis)); 

( 

cb - GlobalSize(hgblThis); 

HTASK htsk; /* Registered client task. */ 

if (I( 1pv - G1obalA11ocPtr(GMEM MOVEABLE, cb))) 

UINT wSel ; /* DGROUP selector for task. */ 

) CDS; /* Client Data Structure. */ 

return FALSE; /* Out of memory. */ 

typedef CDS FAR * LPCDS; 

/* First look for an empty spot in the array. */ 

/* Note: Can't both be zero, so we at least know */ 

BOOL FEnterDll (void) ; 

/* the array has been allocated. */ 

LPCDS LpcdsFindCurTask(void); 

if (ccdsClient < ccdsAlloc) 

int CALLBACK LibMain(HINSTANCE, WORD, WORD, LPSTR); 

( 

int CALLBACK WEP(int) ; 

LPCDS lpcdsLim; 

LPCDS lrgcds; /* Array of registered clients. */ 

for (lpcds * lrgcds. 

int ccdsAlloc; /* Size of client array. */ 

lpcdsLim * lpcds + ccdsAlloc; 

int ccdsClient; /* Count of registered clients. */ 

lpcds < lpcdsLim; lpcds++) 

DWORD tim; /* Time at registration. */ 

if ( 11pcds->htsk) 
break; 

int CALLBACK 

) 

LibMain(HINSTANCE hinsThis, WORD ds, WORD cbHeap, 

else 

LPSTR Isz) 

{ 

/ ***************************************************** J 

/* -- Entry point during initialization. */ 

LPCDS lrgcdsNew; 

! ***************************************************** j 

/* No empty slots, so we we must grow the */ 

{ 

/* array. */ 

/* Start with space for one entry. */ 

if (l(lrgcdsNew * (LPCDS)GlobalReAllocPtr( 

if (!(lrgcds = (LPCDS)GlobalAllocPtr( 

lrgcds, (ccdsAlloc + 1) * sizeof(CDS), 

GMEM MOVEABLE | GMEM SHARE, sizeof *lrgcds))) 

GMEM MOVEABLE))) 

return FALSE; 

{ 

GlobalFreePtr(lpv); 

ccdsAlloc » 1; 

return FALSE; 

return TRUE; 

) 

) 

lrgcds = lrgcdsNew; 

lpcds * lrgcds + ccdsAlloc++; 

int CALLBACK 

WEP(int nExitCode) 

1 

/ ***************************************************** J 

ccdsClient++; 

/* — Exit proc. */ 

fmemcpyOpv, MAKELP(wSelThis, 0), (int)cb); 

j ***************************************************** j 

lpcds->htsk = GetCurrentTaskQ; 

( 

if (lrgcds) 

lpcds->wSel = wSelClient = SELECTOROF(lpv) ; 

G1obalFreePtr(lrgcds) ; 

/* Instantiate some client data. */ 
asm mov ds, wSelClient; 

return 1; 

tim = GetTickCount() ; 

) 

BOOL export 

return TRUE; 

) 

FRegisterTask(void) 

BOOL export 

f ***************************************************** / 

FUnregisterTask(void) 

/* — This export is to called by each task that */ 

/ft**************************************************** j 

/* requires services provided by this DLL, before */ 

/* — Unregister the current task (free associated) */ 

/* the services can be provided. */ 

/* memory. */ 

/* -- Return TRUE for success, FALSE for failures */ 

/* — A task is ineligible for this DLL's services */ 

/* out of memory, or task already registered). */ 

/* after making this call. */ 

f*****************************************************f 

{ 

LPCDS lpcds; 

{ 

LPVOID lpv = NULL; /* Task's DGROUP copy. */ 

UINT wSelThis; /* DLL's DS. */ 
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copy of the code with a separate DGROUP per task — the task 
being the basic unit of execution. A DLL, on the other hand, 
cannot be instanced, and therefore cannot possess tasks. 


Listing 1 continued 


if (1(1 pods * LpcdsFindCurTask())) 
return FALSE; 

GlobalFree( 

(HGLOBAL)L0W0RD(G1obal Handle(lpcds->wSel))); 
lpcds->htsk = NULL; 
lpcds->wSel = NULL; 
ccdsCl ient—; 
return TRUE; 

} 

LPCDS 

LpcdsFindCurTask(void) 

^*****************************************************y 
/* -- Return the client data structure of the */ 

/* current task. Return null if not found. */ 

/★★★★★★★★•AT********************************************/ 

{ 

LPCDS lpcds, lpcdsLim; 

HTASK htsk = GetCurrentTask(); 

if (!ccdsClient) 
return NULL; 

for (lpcds = Irgcds, lpcdsLim * lpcds + ccdsAlloc; 
lpcds < lpcdsLim; lpcds++) 
if (lpcds->htsk *« htsk) 
return lpcds; 

return NULL; 

) 

BOOL 

FEnterDll(void) 

^ *★***★*****★**★*★★★★*★ ★**★*****★★* ★ ★★★★★★★■AT********** j 

/* — Switch to the DGROUP copy of the current task. */ 
/* — Return FALSE if task has not registered */ 

/* itself. */ 

/★★***★★★★*★★*★★***★★**★****★***★****★★***★**★***★*★★*/ 
{ 

LPCDS lpcds; 

UINT wSel; 

if (!(1pcds « LpcdsFindCurTask())) 
return FALSE; 

wSel = lpcds->wSel; 

_asm mov ds, wSel; 
return TRUE; 

) 

LPSTR export 
LszGetTaskData(void) 

^★★*******************Hr*******************************^ 

/* — Return instance data for current task. */ 

y****★★★★★*********************★******★**********★****/ 
( 

static char szMsg[80]; 

if (IFEnterDll()) 
return NULL; 

wsprintf(szHsg, "Task %x has been running %ld“, 
GetCurrentTask(), (GetTickCountQ - tim) / 1000); 
return szHsg; 

1 

/* End of File */ 


It's an interesting design. Since a DLL possesses one 
DGROUP, that data is really shared among all client tasks. For 
example, the User DLL of Windows would not be able to 
return a window handle from the GetFocus() call if the win¬ 
dow with the focus did not belong to the calling task. This 
design transcends the classical concept of library, enabling 
DLLs to possess a life of their own (and adding yet another 
strange concept for the newcomer to master). 

But back to the question. Your suggestion of adding a 
DGROUP manager to the DLL is intriguing. The overhead of 
finding the current task's DGROUP selector from a table and 
setting that value into DS is a small price to pay for a common 
code base. Three potential concerns come to mind: 

1) Will changing DS from an exported procedure cause any 
problems on return to the client task? 

2) Will making a call to a Windows routine from inside an 
exported procedure with DS not that of the DLL's DGROUP 
cause a problem? 

3) Will a context switch from an exported DLL routine with 
DS not that of the DLL’s DGROUP cause a problem (e.g., the 
exported DLL routine called GetMessage())l 

I wrote a little demo DLL and demo client application to 
help answer these questions. Listing 1 is the C source for Ins- 
Dll, a DLL that maintains a per-instance DGROUP; Listing 2 is a 
header file that prototypes its exported procedures; Listing 3 is 
an empty resource file; and Listing 4, the linker’s module 
definition file. The majority of the code in the DLL is used to 
maintain a table of “registered” clients. The table consists of a 
task handle and selector for a DGROUP copy. When a client 
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task calls FRegisterTaskf), a copy of the DLL's DGROUP is 
allocated and initialized, and its selector stored in the table (an 
unused entry is used or the table is grown). Before a 
registered client terminates, it is expected to call F- 
UnregisterTaskf) to free the DGROUP copy and clear the 
task’s entry in the table. The DLL provides one additional ex¬ 
port, LszGetTaskData(). This is a sample service that will set 
DS to a registered task's DGROUP copy. It formats the message 

“Task %x has been running %ld" 

into a static character buffer which is returned to the client 
task. Static variables reside in DGROUP, so simultaneously run¬ 
ning two client tasks will demonstrate multiple DGROUPs if the 
two receive different messages. Just so I had something useful 
to put in the message, the DLL also keeps a global variable 
that records the time when a client task registers itself. This is 
subtracted from the current time so that the elapsed time can 
be included in the message. LszGetTaskData() uses the 
utility routine FEnterDllf) to look up the DGROUP selector 
from the current task handle. If the task has been registered, 
it sets DS and returns TRUE, else it returns FALSE. 

The DLL’s entry point, LibMain(), allocates some initial 
space for the table, and the exit point, wep(), frees the table. 


Listing 2 insdll.h 


I*****************************************************j 

/* insdll.h */ 

/* -- Interface to instanced DGROUP DLL demo. */ 

j*****************************************************j 

BOOL _export FRegisterTask(void); 

BOOL _export FUnregisterTask(void); 

LPSTR _export LszGetTaskData(void); 

/* End of File */ 


Listing 3 empty.rc 


j*****************************************************j 

/* insdll.rc */ 

/* -- Empty resource file. */ 

/***************************************************** j 


Listing 4 insdll.def 


;; insdll.def 

;; -- Module definition file for per-client DGROUP 
;; DLL. 


LIBRARY 

InsDIl 

EXETYPE 

Windows 

CODE 

PRELOAD MOVEABLE DISCARDABLE 

DATA 

PRELOAD SINGLE 

HEAPSIZE 

0 

EXPORTS 



WEP @1 RESIDENTNAME 

_FRegisterTask @2 
_FUnregisterTask @3 
LszGetTaskData @4 


If you use global memory for the table (you could use a local 
heap if the number of clients will be small), you must allocate 
it with GMEM_SHARE. Otherwise, the memory for the table will 
belong to the first task that loaded the DLL, and when that 
task exits, Kernel will free the memory. If subsequent tasks 
used the DLL, the next time one of them called one of the 
exported functions it would UAE. If the number of clients can 
be very large, you should use a huge pointer to maintain the 
table; my implementation uses a far pointer. 

Listing 5 is C code for a small application to test the DLL (in 
a fit of creativity I called it TestDII). It registers itself with InsDIl 
and creates a menu-less top-level window. Once the user 
closes the window and GetMessagef) returns FALSE, the task 
unregisters itself with the DLL. 


Listing 5 testdii.c 


j*****************************************************j 

/* testdll.c */ 

/* -- Demonstrate InsDIl DLL. */ 

y *****************************************************j 

linclude <windows.h> 
linclude "insdll.h" 

char szApp[] = "TestDII"; 

LRESULT CALLBACK WndProc(HWND, UINT, WPARAM, LPARAM); 
fdefine wTimerld 1 


int PASCAL 


WinMain(HINSTANCE hinsThis, HINSTANCE hinsPrev, 

LPSTR lszCommand, int wShowWindow) 

I *****************************************************j 

/* -- Entry point. */ 


{ 


HWND hwnd; 
MSG msg; 


if (!hinsPrev) 

{ 

/* First instance must register a class. */ 
WNDCLASS wcs; 

wcs.style = CS_HREDRAW | CS_VREDRAW; 
wcs.lpfnWndProc = WndProc; 
wcs.cbClsExtra = 0; 
wcs.cbWndExtra ■ 0; 
wcs.hlnstance = hinsThis; 
wcs.hlcon = LoadIcon(NULL, IDIAPPLICATION); 
wcs.hCursor = LoadCursor(NULL, IDC_ARR0W); 
wcs.hbrBackground = (HBRUSH)(C0L0R_WIND0W + 1); 
wcs.lpszMenuName = NULL; 
wcs.lpszClassName = szApp; 
if (!RegisterClass(Swcs)) 
return FALSE; 

I 


if (!FRegisterTask()) 
return FALSE; 


if (!(hwnd = CreateWindow(szApp, szApp, 
WS_0VERLAPPEDWIND0W, CWJJSEDEFAULT, 
CWJJSEDEFAULT, 

GetSystemMetrics(SM_CXSCREEN) / 2, 
GetSystemMetrics(SM_CYSCREEN) / 8, 
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When the window is created, its window procedure, Und- 
Proc(), creates a timer to go off at one-second intervals. 
When it receives a UM_TIMER, UndProc() calls Invalidate- 
Rect() to generate a paint message. The code to handle a 
paint message merely prints the string returned from LszGet- 
TaskData() in the client area using TextOut(). Listing 6 is 
TestDll’s linker module definition file, and Listing 7 is the 
makefile for both InsDll and TestDII. 

Armed with these tools, I could investigate the behavior of 
this concoction. Question 1 proved easy to answer. When a 
DLL is first loaded, the loader uses the relocation table emitted 
by the linker to patch each exported entry point with the 
3-byte instruction mov ax, xxxx where xxxx is the the DLL's 
DGROUP selector. After this instruction the compiler emits a 
prologue, which results in the following code: 


Listing 5 continued 


NULL, NULL, hinsThis, NULL))) 
return FALSE; 

ShowWindowfhwnd, wShowWindow); 
while (GetMessage(&msg, NULL, 0, 0)) 

f 

TranslateMessage(&msg); 
DispatchMessage(&msg); 

} 

return FUnregisterTaskf); 

) 


LRESULT CALLBACK 

WndProc(HWND hwnd, UINT wm, WPARAM wParam, 
LPARAM IParam) 



{ 

switch (wm) 

{ 

default: 

break; 

case WM_CREATE: 
return 

SetTimer(hwnd, wTimerld, 1000, NULL) ? 0 : -1; 
case WMJIMER: 

InvalidateRect(hwnd, NULL, TRUE); 
return 0; 

case WM_PAINT: 

{ 

PAINTSTRUCT wps; 

LPSTR lsz; 

BeginPaint(hwnd, Swps); 
lsz « LszGetTaskDataO; 

Text0ut(wps.hdc, 0, 0, lsz, 1strlen(1sz)); 
EndPaint(hwnd, &wps); 

) 

return 0; 

} 

return DefWindowProc(hwnd, wm, wParam, IParam); 

) 

/* End of File */ 


mov ax, xxxx 
push ds 
mov ds, ax 

The compiler also emits the epilogue: 
pop ds 

So any routine exported from a DLL (compiled with MSC 7.0 at 
least) preserves the DS register of the caller, in fact, this is an 
absolute necessity for every routine exported from a DLL. If 
the DS register were not preserved upon return to the caller, 
things would get ugly fast. Since every routine in the Win¬ 
dows API is exported from a DLL, DS will be preserved on any 
call to one of these routines. This takes care of question 2, 
and, in theory, should have answered the last question as 
well, since GetMessagef) and its ilk are exported DLL routines. 
My worry was that during a context switch, private data in 
the DLL's DGROUP would end up in one of the DGROUP copies 
instead. An examination of GetMessage(), PeekMessage(), and 
Yield() reveals that context switches occur in an unnamed 
routine at offset 0x89ec (Windows debug version) in the same 
code segment that contains Yield(). The DS of the incoming 
task is extracted from a global variable in Kernel which 
depends on the value of DS when GetMessagef), etc., was last 
called by the incoming task. 

It would seem that your proposed solution is viable. When 
I ran multiple instances of TestDII, each behaved as expected, 
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Listing 6 testdll.def 


;; testdll.def ;; 

;; — Linker definition file InsDll demo app. ;; 

NAME TestDll 

DESCRIPTION 1 DGROUP DLL demo' 

EXETYPE WINDOWS 

STUB 'WINSTUB.EXE' 

CODE PRELOAD MOVEABLE DISCARDABLE 

DATA PRELOAD MOVEABLE MULTIPLE 

HEAPSIZE 1024 

STACKSIZE 10240 

EXPORTS 

WndProc @1 


displaying a unique message after each repaint. So to answer 
your questions, yes, I think you can use the technique to 
solve your problem, and, yes, it makes sense to me. As for 
good Windows programming practice, well, it is a bit un¬ 
savory. And it absolutely will not work with the Win32 API, 
but this is not really a problem since the Win32 API supports 
instanced DLL data. However, I would heavily test any im¬ 
plementation making use of this technique, especially concur¬ 
rently with other running programs. 

If you do decide to use this approach, you can improve 
InsDll in a couple of ways. First, you could do away with F- 
RegisterTaskf) and put code in FEnterDll() to implicitly 
register any unregistered task. You could also do away with 


Listing 7 makefile 


####################################################### 
f# makefile ff 

## — Project file for per-client DGROUP demo DLL. ## 
####################################################### 
ell: insdll.dll testdll.exe 

.c.obj: 

cl -c -ASw -G2w -Od -Zdpe -W3 -DSTRICT $(DEFS) $< 

insdll.obj: insdll.c 

testdll.obj: testdll.c 

insdll.dll: insdll.obj empty.rc insdll.def makefile 

link /NOD/map insdll libentry, insdll.dll,, \ 
libw sdllcew, insdll.def 
implib insdll.lib insdll.def 
rc $(DEFS) empty.rc insdll.dll 
mapsym insdll 

testdll.exe: testdll.obj testdll.def empty.rc \ 
insdll.lib makefile 

link /NOD/map testdll,,, libw slibcew insdll, \ 
testdl1.def 

rc $(DEFS) empty.rc testdll.exe 
mapsym testdll 


FUnregisterTask() by using the toolhelp.dll Notify- 
Registerf) routine to register a callback to track exiting 
tasks. Then when a registered task exits, you could use the 
code of FUnregisterTask(). □ 
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Microsoft C/C++ Programming: 
The Accessible Guide 
to Professional Programming 

Reviewed by Massimo Cesaro 


Steven Holzner’s Microsoft C/C++ Programming: The Acces¬ 
sible Guide to Professional Programming, available from Brady 
Books, is an introduction to C++ and Windows 3.x program¬ 
ming using the Microsoft implementation of C++. The book re¬ 
quires previous knowledge of the C language, which serves as 
a starting point to the evolution of programming with object- 
oriented techniques. 

Synopsis 

Microsoft C/C++ Programming includes a disk that contains 
all the examples in the book as well as three additional com¬ 
plete programs. The book is structured as follows: 

Introduction. The introduction illustrates the technique the 
author uses to develop C++ programming skills for a C 
programmer. In brief, the approach is to dissect the many ex¬ 
amples included and compare them with traditional solutions. 

Chapter 1: Our Review of C. Starting with a brief history of 
C, the author covers all the features of the language in 50 
pages. This chapter is not intended to teach C or programming 
techniques; instead, it can be used as a self-test for the 
reader. If you don’t find yourself more than comfortable with 
the arguments in the chapter, then you should refresh your 
knowledge with a pure C book before proceeding with the 
reading. 

Chapter 2: Welcome to C++: Classes and Objects. This chap¬ 
ter shows areas in which C++ improves on C, notably objects 
and classes. The author uses some simple examples - an 
input character counter and a stack object — to introduce im¬ 
portant concepts like objects, classes, constructors and 
destructors, object arrays, and inheritance. The examples in 


this chapter, like the others in the book, are dissected and 
examined line by line, with explanations of the inner workings 
of the language. As a C programmer, I found the line-by-line 
explication really useful, because it is easy to learn a relatively 
new language if you have some knowledge of its operations. 
For the novice, there is also a brief description of how to suc¬ 
cessfully compile and link a C++ program using either NMAKE 
or PUB. 

Chapter 3: Functions, Operators, and Overloading. This chap¬ 
ter introduces concepts like operator overloading; private, 
public, and friend functions; inline functions; pointers to ob¬ 
jects; and memory management in C++. The stack object of 
the previous chapter is expanded to support new 
functionality, and the unavoidable string class is presented. 
The author doesn't spend much time on this class, however, 
as he chooses instead to illustrate the Microsoft Foundation 
Classes (MFC) CString class and some of its many member 
functions. 
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Chapter 4: C++ inheritance and Polymorphism. Chapter 4 
provides an extensive discussion of inheritance, leaving the 
reader in no doubt about why, where, and when class in¬ 
heritance should be used. Member protection, nested classes, 
and inherited constructors are well explained, as are multiple 
inheritance, virtual functions, and abstract classes. The chapter 
also offers a simple introduction to object-oriented jargon. 
Two topics — polymorphism and early vs. late binding — 
deserve more attention than they are given here: in fact, a 
full-featured program example would have been welcome. 

chapter 5: C++ I/O Class Libraries. This chapter explains 
input and output formatting, showing how both are really im¬ 
plemented. This allows the reader to see how and when 


some C++ techniques are used in actual class development. 
The chapter also introduces file handling in C++ and provides 
examples of writing and reading a file in ASCII or binary mode, 
reading and writing objects to disk, and object serialization 
(e.g., writing objects to disk) using the MFC file handling. With 
this section, DOS gives way to Windows in the program ex¬ 
amples. 

Chapter 6: Welcome to C++ for Windows. Chapter 6 
focuses on the differences between writing a program for 
Windows in C and writing such a program in C++. There is a 
description of GUI and event-driven environment programming 
and conventions, but the description is really too short to be 
useful. On the other hand, for the novice C++ programmer, the 
comparison between a C and a C++ 
Windows application with an explana¬ 
tion of how Windows programs should 
be designed in C++ (using message 
mapping, the application class, the 
frame window class, and the device 
context class) is extremely useful. The 
example makes full use of the MFC clas¬ 
ses for Windows and this is where the 
book really shines: if you want to start 
developing Windows applications in C++ 
quickly, this is the place to look for 
hints. 

Chapter 7: Keyboard and Mouse Input. 

Chapter 7 shows how to build a Win¬ 
dows executable file and concisely ex¬ 
plains some techniques for using the 
mouse and the keyboard through mes¬ 
sage mapping. The main example is a 
Windows application that reads user 
input from the keyboard and writes 
characters in the client area of a win¬ 
dow. The program shows a caret and 
the techniques for manipulating it. 

Chapter 8: Menus. This section covers 
conventions used in designing and or¬ 
ganizing menus and menu items and il¬ 
lustrates the use of resource files and 
the resource compiler. The author 
doesn't deal with esoteric examples 
such as adding a bitmap to a menu or 
using pop-up menus, but does discuss 
accelerators, graying, and checkmarking 
items. The Phonebook example, while a 
little primitive, does help you to learn 
how to add menu items at runtime. 

Chapter 9: Dialog Box. Starting with 
message boxes and ending with a full- 
featured modal dialog box, this chapter 
also provides a short introduction to the 
SDK Dialog Editor. The author describes 
the CModalDialog class and explains 
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+ +n; 

) 
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int main() 
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how to derive custom dialog classes to use in your own 
programs. A simple calculator application (really nothing more 
than an addition calculator) provides a step-by-step example 
of how to write the code for a dialog box using C++. The 
Notepad example is a little more useful in that it shows some 
tricks in using the multiline edit control, including how to use 
the scrollbar class. 

Chapter 10: Graphics and a Mouse-driven Paint Program. 

The last chapter shows the power of C++ in a small, fast, and 
easy-to-understand paint program. The author summarizes all 
the notions presented in the book to show how a fairly com¬ 
plex project in a complex environment such as Windows can 
be easily managed in C++. The program allows the user to 
draw some geometric figures: points, 
lines (in many styles), rectangles 
(hatched and filled), ellipses, and even 
freehand drawing. The program sup¬ 
ports rubber-banding of objects (which 
the author call "stretching") through the 
use of ROP codes. Last, but not least, 
the chapter shows how to include a 
program icon in the executable file, 
with a brief explanation of SDK Image 
Editor application. 


managers who want to know the benefits to be derived from 
using C++ in Windows applications development. The ex¬ 
amples are well written and commented - they are the 
skeleton of the book. Very interesting also are the many 
“hints" and "tips" scattered through the book. The figures and 
the pictures, however, are not as clear as they might have 
been, and, in fart are sometimes hardly distinguishable from 
the text. 

Steven Holzner’s writing is clear and concise, and the in¬ 
clusion of the disk makes it easy to read the book while run¬ 
ning the examples, side by side. This is undoubtedly not the 
last book that you will buy on the subject, but it is very 
handy -especially if you don’t want to read all the documen¬ 
tation that comes with Microsoft C/C++ at once. □ 


Appendix A: Using Assembly Language 
with C++. The most interesting topic in 
the first appendix is the description of 
the internal C++ data formats. The sec¬ 
tion explains integers, long integers, and 
signed and floating point format, and 
gives little examples of how to pass 
them back and forth to assembly lan¬ 
guage sections of your programs. 

Appendix B: About the Diskette. This 
appendix describes the content of the 
disk that accompanies the book. 


Comments 

You cannot condense Petzold’s book 
(The Windows Bible) in 200 pages, so 
this book doesn't pretend to be a book 
on programming Windows, even though 
discussions and examples presented are 
weighted more heavily toward Win¬ 
dows than toward DOS. To fully ap¬ 
preciate the book, the reader should be 
comfortable not only with C program¬ 
ming, but also with Windows program¬ 
ming (a novice in Windows develop¬ 
ment would find the book sketchy and 
certain points obscure). The ideal 
audience for this book would be skilled 
C programmers who want to update 
projects using C++, professionals who 
want a taste of what C++ programming 
for Windows can be, and project 
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Quadbase-SQL for Windows v2.0 is an industrial-strength SQL relational database 
engine that allows Windows developers to build applications using various languages 
like Visual Basic, Realizer, Toolbook, SQLWindows, C, C++, etc. A unique 
interpretive, language-independent embedded SQL interface included with the system 
makes using any Windows language easy. The SQL engine, implemented as a DLL, is 
fully ANSI SQL 89 level 2 compliant, and supports the Microsoft ODBC standard, 
which provides seamless, object-oriented access from Visaul Basic v2.0. Extensions 
include referential integrity, scroll cursors, and outer join, along with other advanced 
features such as multi-user concurrency control, crash recovery, transaction processing, 
multiple instances, BLOB data, and read-only schemas for CD ROMs. The engine is 
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efficiently. Visual Basic development is enhanced by embedded SQL and custom 
controls for browsing and data entry. dQUERY, an award winning query tool/report 
writer, and VBQUERY, an interactive query tool for Windows, are included for quick 
prototyping of SQL statements. A 'C' language programming interface is also provided 
together with an embedded SQL preprocessor. The native file format is dBASE. This 
product is ideal for small to medium sized LAN file server systems, standalone laptop 
machines, or pen-based systems. Users can benefit from advanced relational database 
features while opening a migration path to SQL servers. 

Quadbase Systems Inc. 
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Sunnyvale, CA 94086 
Tel: (408) 738-6989 
Fax: (408) 738-6980 
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Murray L Lesser 





Extending 


My unhappiness with DOS’s CLS command began when I replaced the mono 
adapter and lovely green screen in my old PC XT with an EGA and “Enhanced" color 
display. Instead of restful light green letters on a dark green ground, I was now faced 
with stark white on dead black. A little hunting around in COMMAND.COM with DEBUG 
taught me how a patch would produce a more pleasing display. I went through 
about three color changes — repatching each time — before I found one I could live 
with. 

There are other problems with CLS as furnished. For example, it doesn't reset the 
mode from whatever was left by a poorly behaved application program, even if that 
mode was 320x200 pel CGA-compatible graphics. But I suffered with what I had until 
I learned about installable internal DOS commands in Chapter 6 of Undocumented 
DOS (Schulman 1990). Suddenly, I realized that I could change the way CLS operated 
if I wanted to. The material in the reference took me only so far - this article 
includes the necessary additional information I had to figure out for myself. 

Installable internal DOS commands have been available since DOS 3.3. These resi¬ 
dent extensions of COMMAND.COM respond to the multiplex function request (INT 2F) 
issued by COMMAND.COM after it parses the command-line entry but before it acts on 
the command, and can replace existing internal commands (executed directly by 
COMMAND.COM ), or add new such commands. The example shown here is clearit.asm 
(Listing 1), a replacement for COMMAND.COM's CLS command, clearit.com is a tiny TSR 
(368 bytes, installed) that responds when CLS is entered on the command line. As 
written, it resets the display to mode 3 (80x25 alpha) using the color attribute 
specified by the command-line parameter at installation. 

The Multiplex Interface 

Installable internal commands operate through the INT 2F multiplex interface. In 
general, the multiplex interface consists of a string of chained INT 2F handlers, each 
having an assigned signature. A program wishing to make use of one of the poten¬ 
tial multiplex services tests for its existence by placing the appropriate signature 
word in register AX and executing an INT 2F. As each installed handler receives the 
request (in reverse order to the installation sequence), it checks for its own signa¬ 
ture. If it is present, that handler responds by putting the acknowledgment signature 
into AX and executing an IRET. If it is not present, the request is handed on by a 
far jump to the next-previously installed handler. If there is no handler for the func¬ 
tion, the DOS default INT 2F handler returns an unadorned IRET. If the requesting 


Murray L. Lesser received a BS degree in Engineering from CalTech in 1942 and earned 
his living as a programmer until 1954, when he joined IBM to work in what would 
become “systems architecture." He has been programming microcomputers and writ¬ 
ing books and articles about the subject since 1979 (but claims no responsibility for 
the IBM PC, having retired before it was announced). 
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COMMAND.COM 


program receives the proper acknowledgment to its “are you 
installed?" query, it sends the “do it" request with another INT 
2F and a different signature. 

You are free to write your own INT 2F handlers, using 
any signature not in the DOS reserved range ( OOOOh - OBFFFh) 
(though if you are writing a unique handler to be used on 
someone else’s system, you must be careful not to create an 
identity problem). However, there is at least one reserved ser¬ 
vice for which you can write your own handler: the installable 
internal command. 

One caution: According to several editions of IBM's DOS 
Technical Reference, any INT 2F handler that uses DOS calls or 
executes with interrupts enabled must be re-entrant. This 
caution does not appear in other texts I have seen. 

The Installable Command 

Each time COMMAND.COM reads the entry on a command 
line, it executes an INT 2F with the following three signature 
values: AX contains the “are you there?” query, OAEOOh-, DX 
contains a second signature word, OFFFFh-, and DS:SI points to 
a buffer containing the command name. All three must be 
matched before a handler responds to the request. 

When the interrupt is executed, both ES and DS point to 
the segment containing COMMAND. COM's temporary buffers. 
DS-.BX (or ES:BX) points to a buffer usually containing an 
image of the command line just read. The first byte in this 
buffer is always 80h, the second byte is the number of sym¬ 
bols just read, not including the final <CR>. You can parse the 
DS:BX buffer if your installable command requires command¬ 
line parameters, providing there are no redirection symbols on 
that line. (What COMMAND.COM does with redirection symbols 
depends on what they are. In general, they will be acted on 
before the DS-.BX buffer is written. An output redirection 
filename may be deleted and the string shortened according¬ 
ly. The first remaining redirection symbol will usually be 
replaced by a <CR>, which will become the terminating sym¬ 
bol for establishing the length count.) 

For commands that might be internal commands (no drive 
or path specified), DS:SI points to a buffer headed by a byte 
giving the number of characters in the command name (only), 
followed by that name in all caps. If the command-line entry 
included an extension, it will also appear —following the name 
padded with blanks to eight symbols. However, if any drive or 


path was specified, the DS:SI buffer will always show a com¬ 
mand length of eight bytes, and the character string may or 
may not be correct. The command is identified as belonging 
to this handler by comparing both the number of bytes ex¬ 
pected and the name, so you should avoid installing com¬ 
mands with eight-byte names. 

Since most INT 2F interrupts are not for clearit, several 
signature checks are run to eliminate non-candidates as soon 
as possible. The new interrupt handler checks first for the 
OFFFFh in DX, and chains to the “old" INT 2F vector if this 
simple test shows the call is not for it. The second test is for 
the command name, as shown in the code between the pair 
of dashed lines. If this also passes, the last test is for the “offi¬ 
cial" signature in AX. A value of OAEOOh is the “are you there?” 
query; the response is to replace the value in AX with OAEFFH 
and execute an IRET. Finding OAEOlh in AX is the “do it” call, 
causing the substitute CLS command to be executed. After 
execution, clearit assures COMMAND.COM that the command 
was handled by zeroing the command-length byte at DS:SI 
and executing an IRET. 

Installing clearit 

The installation phase of clearit starts at the INIT label. 
Since the installable internal command facility did not exist 
prior to DOS 3.3, the First check is for the DOS version. A failure 
here terminates the installation with an error message and a 
1 exit code. 

INIT next checks for the color attributes to be used (see 
Figure 1 for the standard BIOS text-display color values). Any of 
the 16 values may be used for foreground color; only the first 
eight for background (adding the high bit to the background 
value produces a blinking display). 

If there is no command-line parameter at installation, the 
default white on black attribute ( 07h ) is used. Color attributes 
are represented as one- or two-digit hex numbers: if a two- 
digit number, the first digit is the background color, the 
second, the foreground; a one-digit number identifies a 
foreground color to be used on black. This coding scheme was 
picked for programmer's convenience, not user friendliness, as 
it is expected that clearit will be loaded from AUTOEXEC.BAT. 
No built-in mechanism prevents you from using the same 
color for both foreground and background, though the display 
would be somewhat hard to read. 


February 1993 


Windows/DOS Developer's Journal — Page 75 


Build 
better 

applications 
now with. . . 



lU-USTRAT^ 


Leor Zo"" a " 



Illustrated C 

by 

Leor Zolman 

CUJ columnist and author of BDS C 


Discover the WHY and 
HOW of application design 
and development in C. 
Explore the construction of 
several different applications 
from start to finish. Chapter 
after chapter you’ll develop 
your skills through in-depth 
tutorial and detailed code. 



(*3925 with disk) 


CALL TODAY! 

913 - 841-1631 

FAX 913-841-2624 


R?D 

publications, inc. 




Next, the memory block occupied by 
clearit's environment segment is 
released, thereby making it available to 
hold the environment segment for the 
next process to be loaded. Then, INT 
2F is hooked, after which the resident 
portion is left in place. 

I have written the clearit interrupt 
handler as a TSR, rather than as a 
device driver, mostly to simplify the 
programming for handling command¬ 
line parameters. I find it convenient to 
test TSRs in DESQview-386 "DOS” win¬ 
dows, where the effects can be 
removed by closing the window. I used 
multiple "Little Dos” (128Kb) windows to 
experiment with color attributes before 
I decided that I really preferred green 
on black. I now load clearit 2 with 
AUTOEXEC.BAT. 


Problems and Pitfalls 

Because I have used the assembler 
ALIGN directive (primarily to separate 
the interrupt handler code from the 
transient portion), clearit cannot be 
assembled with the original distribution 
version of MASM 6.0 (I have called it 
MASM 6.00 in the WARNING on the list¬ 
ing). When I informed Microsoft of the 
ALIGN bug in MASM 6.0, I was told that 
this was “a known bug.” So I sent the 
useless assembler back and received a 
refund. 

I assembled clearit both with 
TASM 2.5 (the version that comes with 
Borland C++) and MASM 5.1, getting 
identical results. It has been tested on 
my PS/2 model 80 under both IBM-DOS 
5.0 and IBM-DOS 3.3, each running 
QEMM-386 v6.0. It has also been tested 


Listing 1 clearit.asm 


.*********************************************************************** 
; CLEARIT.ASM * 

; CLEARIT.COM is a TSR substitute for the C0MMAND.COM internal CLS * 
; conmand. CLEARIT's CLS clears the video display to 80 x 25 alpha * 

; mode with the attribute set as specified by the (up to) two hex * 

; digits given as a command-line parameter when the TSR is loaded. * 

; CLEARIT uses the "installable conmand" undocumented function OAEh * 
; in "multiplex" INT 2Fh, available in DOS versions 3.30 and later. * 

; CLEARIT will not install under earler versions of DOS. * 

; Copyright (C) 1991, Murray L. Lesser * 

; WARNING: This code will not assemble correctly with MASM 6.00. * 

.*********************************************************************** 

CODE SEGMENT PARA PUBLIC 'CODE' 

ASSUME CS:C0DE, DS:C0DE, ES:C0DE 



0RG 

100H 


BEGIN: 

JMP 

INIT 


ATTRIB 

DB 

07 

•.Default attribute (white on black) 

ALIGN 

4 



OLDHANDLER DD 

0 

jOriginal INT 2Fh vector 

COMMAND 

DB 

3,'CLS' 

;Identity string for this command 

NEW HANDLER: 

;New 

interrupt 2Fh handler 


CMP 

DX.OFFFFH 

;Extra signature word for function OAEh 


JZ 

MAYBE 


CHAIN: 

JMP 

CS:OLDHANDLER 

1 ;Send calling message up the line 

MAYBE: 

;Check if this is 

our command: 


ON ENTRY: 

ES and DS point to COMMAND.COM's transient data segment. DS:SI 
points to a byte showing the number of bytes in the conmand name 
(only) followed by an 11-byte string containing that conmand name, 
trailing blanks, and any extension, all in caps. 

ON EXIT: 

Zero flag set if 3-byte conmand string is “CLS". Registers saved. 


PUSH 

CX 

;Save registers 

PUSH 

ES 


PUSH 

DI 


PUSH 

SI 


PUSH 

cs 

;Set ES to this segment 

POP 

ES 


MOV 

DI,OFFSET 

COMMAND 

MOV 

CX.4 


REPE 

CMPSB 

;Check command name 

POP 

SI 


POP 

DI 


POP 

ES 


POP 

CX 
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on my 8088-powered IBM XT under 
IBM-DOS 3.3 (rny copy of IBM-DOS 3.3 
has been corrected using the vendor- 
supplied patches). 

However, there is one potential pit- 
fall: on a system running with ANSI.SYS 
installed, clearit appears to do only a 
partial job. Actually, the replacement 
CLS works fine, but its color attribute is 
shown only by the cursor and the un- 
written-on background. All text is dis¬ 
played in whatever attribute ANSI.SYS 
has been coded for. 

There is no reason for any program 
written originally for the PC to require 
performance-reducing ANSI. SYS instead 
of using the more capable BIOS func¬ 
tions. So if your system includes 
ANSI.SYS out of inertia, my advice is to 
remove it from your CONFIG.SYS file. If 
you are still using an obsolete program 


Figure 1 Standard BIOS 

Color Values 

Hex Byte 

Color 

0 

Black 

i 

Blue 

2 

Green 

3 

Cyan 

4 

Red 

5 

Magenta 

6 

Brown 

7 

White 

8 

Gray 

9 

Light Blue 

A 

Light Green 

B 

Light Cyan 

C 

Light Red 

D 

Light Magenta 

E 

Yellow 

F 

White (High Intensity) 


Listing 1 

continued 



JNZ 

CHAIN 

If not ours send message up the line 

CMP 

AX.0AE00H 

Our command, is it first call? 

JNZ 

NEXT 

If not, may be second call 

MOV 

AX.OAEFFH 

Ours, first call, acknowledge we will 

IRET 


handle and return to COMMAND.COM 

NEXT: CMP 

AX.0AE01H 

Our second call? 

JNZ 

CHAIN 

Not our INT 2Fh function (unlikely!) 

; Execute CLS 

command: 


PUSH 

BP 

Save registers used 

PUSH 

AX 

(Even though BP not used, save it 

PUSH 

BX 

anyway. Some early video BIOS’s 

PUSH 

cx 

changed BP.) 

PUSH 

DX 


MOV 

AX ,3 

Reset video mode to 80x25 alpha 

INT 

10H 

(Resets to mode 7 if mono adapter) 

MOV 

AX.0600H 

Use “scroll up to blanks" to 

MOV 

BH,CS:ATTRIB 

set all attribute bytes to ATTRIB 

XOR 

cx.cx 

starting at row 0, col 0, 

MOV 

DX.184FH 

and ending at row 23, col 79 

INT 

10H 


XOR 

AL.Al 

Tell C0MMAND.COM we handled this one 

MOV 

DS:[SI],Al 

by zeroing the command length 

POP 

DX 


POP 

CX 


POP 

BX 


POP 

AX 


POP 

BP 


IRET 


and return to C0MMAND.COM 

ALIGN 16 



; End of resident code - Memory space from here will be released 

ERRORMES DB 

'CLEARIT requires DOS 3.30 or later to install 1 

DB 

13,10,'$' 


INIT: 



MOV 

AH.30H 

Check for proper DOS version: 

INT 

21H 


XCHG 

AH.AL 

;Dumb DOS! 

CMP 

AX.031EH 


JAE 

VERSOX 


; Abnormal end for early DOS version: 

MOV 

AH,9 

•.Display error message 

MOV 

DX,OFFSET ERRORMES 

INT 

21H 


MOV 

AX.4C01H 

;Terminate with exit code 1 

INT 

21H 


VERSOX: MOV 

SI.80H 

;Check command-line attribute 

LODSB 



OR 

AL.AL 

;Anything there? If not. 

JZ 

ENV 

; use default attribute 


YOU 


BUILDING 


m 

a] j 



C++ 


program ? 
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(ported from another system) that re¬ 
quires ANSI.SYS to imitate the ANSI 
console attached to the original beast, 
your best bet is to run that program 
only in a DESQview-386 window, using 
DESQview's DVANSI.COM in the window 
instead of installing the ANSI.SYS driver. 

Of course, it is always possible to 
write a program, customized for your 
system configuration, that selectively 
deletes or restores the effects of an in¬ 


stalled ANSI.SYS driver. This involves 
playing with the linked list of device 
drivers and the vectors corresponding 
to the interrupts hooked by ANSI.SYS. 
But that is another story. 

References 

1. Schulman, Andrew, et al. 1990. Un¬ 
documented DOS (Reading, MS: Addison- 
Wesley), 373-379. □ 


Listing 1 

continued 


CBW 


;Delete leading blanks 

MOV 

CX.AX 


MOV 

AL,' ' 


MOV 

DI.SI 


REPE 

SCASB 


DEC 

DI 


MOV 

SI.DI 

;Check for first hex digit: 

CALL 

CHECKIT 

;Is it valid? 

JC 

ENV 

;If not, use default attribute 

MOV 

AH.AL 

;If so, save first digit 

CALL 

CHECKIT 

;Is there a second valid digit? 

JC 

ONE 

;Only one digit on command line 

MOV 

CL,4 

;Else shift first digit to 

SHL 

AH,CL 

; high nibble 

OR 

AH.AL 

; and combine with second 

ONE: MOV 

ATTRIB.AH 

{Store in ATTRIB 

; Release memory holding CLEARIT's environment block: 

ENV: MOV 

AX,ES:[2CH] 

•.Environment segment address is here 

MOV 

ES.AX 


MOV 

AH.49H 

{Release environment memory segment 

INT 

21H 


; Save and replace INT 2Fh 

vectors: 

MOV 

AX.352FH 


INT 

21H 


MOV 

WORD PTR OLDHANDLER.BX 

MOV 

WORD PTR 0LDHANDLER+2.ES 

MOV 

AX.252FH; 


MOV 

DX,OFFSET NEW HANDLER 

INT 

21H 


; Free memory 

starting at 

ERRORMES: 

MOV 

DX,OFFSET ERRORMES 

MOV 

CL,4 


SHR 

DX.CL 

;Now in Paragraphs 

MOV 

AX.3100H 

{Terminate and stay resident 

INT 

21H 


CHECKIT: 

{Subroutine 

for INIT - If ASCII byte in AL is 


;a valid hex digit, convert to numeric hex byte. 

LODSB 


{Load command-line byte 

CMP 

AL,"0“ 


JL 

NOPE 

{Below ASCII "zero" 

CMP 

AL,"9" 


JBE 

OK 

{Valid numeric digit 

CMP 

AL, 1 A‘ 

{Try for hex digit above 9 

JL 

NOPE 

{Special character between '9' and 'A' 

AND 

AL.ODFH 

{Make cap (if letter) 

CMP 

AL.'F' 

{Final range check 

JA 

NOPE 


ADD 

AL,9 

{Convert low nibble to hex digit 

OK: AND 

AL.OFH 

{Strip off high nibble 

RET 


; and return 

NOPE: STC 


{Set carry flag to indicate failure 

RET 



CODE ENDS 



END 

BEGIN 


; End of File 
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New Products 

Industry-Related News & Announcements 


MASM v6.1 Arrives 

Microsoft has updated their Macro Assembler Profes¬ 
sional Development System. MASM v6.1 offers instruction 
timing, optionally providing the programmer with the execu¬ 
tion time for each instruction. New high-level directives in¬ 
clude IF/ELSE, WHILE, REPEAT/UNTIL, BREAK, and CONTINUE. 
MASM v6.1 supports Windows NT by supporting both COFF 
(Common Object File Format) and OMF (Object Module For¬ 
mat) files. Programmers can assemble for Windows NT under 
DOS and Windows (but this also requires the Windows NT 
SDK). 


MASM v6.1 comes with CodeView v4.0, which allows 
remote debugging and supports debugging of C++ programs. 
The package includes a new Programmer’s WorkBench, an 
integrated environment for editing, browsing, assembling, 
linking, and debugging. The new WorkBench is faster and of¬ 
fers overlapping as well as tiled windows. 

MASM v6.1 costs $199; owners of previous versions can 
upgrade for $49. For more information, contact Microsoft 
Corporation, One Microsoft Way, Redmond, WA 98052- 
6399, (206) 882-8080; FAX (206) 936-7329; Telex 160520. 


Classic Ships Trio of Btrieve Tools 

Classic Software, Inc, is shipping three new tools for 
creating applications that take advantage of Novell Btrieve 
database functions. 

VBtrv combines a DLL written in C and C++ with Visual 
Basic interface modules to provide Visual Basic Windows 
programmers with access to Novell Btrieve v5.1. VBtrv 
transparently manages position block, key buffers, and the 
current key for you. The package offers simplified functions 
for file and index creation, set-based extended operations, 
and multi-user locking. 

CBtrv is a C library that supports Novell Btrieve. CBtrv is 
written in C++ with a C interface layer, providing object- 
oriented capabilities to standard C development It 
transparently manages position block, key buffers, and the 
current key, and implements all Btrieve v5.1 operations as 
standalone functions. The package provides an interface to 
file and index creation, data buffer management, Btrieve 
Record Manager parameter setting, and error logging. CBtrv 


BOUNDS-CHECKER V2.0 

BOUNDS-CHECKER is a DOS tool designed to help C/C++ 
programmers track down a variety of memory and pointer 
bugs. BOUNDS-CHECKER v2.0 not only detects problems in 
the heap, stack, or data segment, but also detects array over¬ 
runs and automatically finds code overwrites and illegal 
memory access outside of your program. 

The original BOUNDS-CHECKER sometimes popped up on 
legitimate out-of-bounds memory access such as video 
memory and BIOS variables. The new version has a Smart 
Mode feature to deal with this problem. Smart Mode uses a 
built-in knowledge base of heuristics to automatically decide 
which out-of-bounds memory accesses are legitimate. 


supports Windows and OS/2 with a common interface for 
portability. 

Btrvgen++ is a database code generator for Btrv++, the 
company's C++ class library interface to Novell Btrieve v5.1. 
Using Btrvgen++'s Windows dialog interface, you define a 
data dictionary for your database: tables, columns, indexes, 
and relationships. Then, Btrvgen++ generates ANSI C++ clas¬ 
ses derived from Btrv++ classes to implement the database 
interface. Alhtough Btrvgen++ is a Windows application, the 
generated code supports Windows, DOS, and OS/2 

VBtrv costs $249 for Visual Basic source and Windows 
DLL, or $389 with C/C++ source (requires Microsoft C/C++ v7.0 
or Borland C++ v3.x), and is royalty free. CBtrv costs $249 or 
$389 with source, is royalty free, and supports Microsoft 
C/C++ v7.0, Borland C++ v3.x, and other ANSI C compilers. 
Btrvgen++ costs $229, or $449 bundled with the Btrv++ 
library. For more information, contact Classic Software, In¬ 
corporated, 3542 Pheasant Run Circle, Suite 8, Ann Arbor, 
Ml 48108,(313) 677-0732. 


The original program also required you to link in a spe¬ 
cial module and use Nu-Mega's own memory manager. 
BOUNDS-CHECKER V2.0 does not require you to link in or com¬ 
pile anything. The product supports both Microsoft C/C++ 
v 7.0 and Borland 3.1 with VROOM overlay, and also supports 
third-party memory managers such as QEMM and 386MAX. 

BOUNDS-CHECKER v2.0 costs $199 and requires at least an 
80386. For more information, contact Nu-Mego Tech¬ 
nologies, Inc., P.O. Box 7780, Nashua, NH 03060-7780, 

(603) 889-2386; FAX (603) 889-1135. 
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EIITech Offers Windows Compression and Database Libraries 


Compression Plus for Windows is a DLL of assembly lan¬ 
guage routines that provide data compression services. The 
library supports six different compression algorithms, includ¬ 
ing modified Huffman, LZW, LZ78, imploding, and shrinking. 
You can use the library to create and manipulate .zip files 
directly. High-level routines in the library an handle file I/O 
and memory management for you, or you an all the 
library’s low-level compression routines directly. 

EIITech E-Tree Plus for Windows is a multi-user database 
library. It detects the presence of Novell and NetBIOS and 
handles low-level File and record locking automatially. The 
same code works on single-user systems without modifia- 


tion. The documentation is written specifially for BASIC and 
Visual Basic programmers and provides a step-by-step intro¬ 
duction to creating a network-aware database. 

Compression Plus for Windows costs $249 and is royalty- 
free. EIITech E-Tree Plus for Windows costs $249 and includes 
full source code. DOS versions of both products compatible 
with QuickBasic, PDS, VB-DOS, and PowerBASIC v3.0 are also 
available. For more information, contact EIITech Develop¬ 
ment, Inc., 43/4 Shallowford Industrial Parkway, Marietta, 
GA 30066, (800) 553-1327 or (404) 928-8960; FAX (404) 
924-2807; BBS (404) 928-7111. 


XYLOS Provides DOS Multitasking and Messaging 


XYLOS is a new multitasking message system for DOS C 
programs. XYLOS provides preemptive tasks, with a round- 
robin scheduling system. A task retains control until it yields 
or is scheduled by the interrupt dock. XYLOS takes ad¬ 
vantage of expanded memory; up to 253 tasks (64KB of ex¬ 
panded memory each) an run simultaneously. 

XYLOS provides a Link Error Recovery System. Up to 
seven XYLOS network drivers an be used concurrently to 
access the various clusters and nodes. Each node connection 
an be configured with two links, allowing multiple connec¬ 
tions in the node paths. This an provide automatic link error 
recovery —an outage in one node or link need not become a 
full system outage. 


XYLOS provides semaphores to allow tasks to 
synchronize access to common resources. XYLOS also 
provides a message-passing system for intertask communia- 
tion. A task waiting for a message will be suspended until 
the message arrives or until a user-specified time-out period 
expires. Messages allow XYLOS tasks to communiate with 
each other loally or remotely. The underlying network com- 
muniation is not visible to the programmer. An event mes¬ 
sage system lets the application program monitor the 
DOS/XYLOS event state for the active task. 

XYLOS prices start at $86 and the product supports 
Turbo and Borland C. For more information, contact Tampa 
ModTech, Inc, P.O. Box 261465, Tampa, FL 33685, (813) 
882-9795. 


TPW Goes Corporate 

Borland has released Borland Pasal with Objects v7.0, a 
complete Pasal development package for DOS, DOS 
Protected Mode Interface (DPMI), and Windows. The new 
package offers the unique ability to create DLLs that an be 
used in both DOS and Windows. 

You an use Borland Pasal with Objects to create DPMI 
appliations that an access up to 16Mb of memory for code 
and data. You can use the package to create DOS and Win¬ 
dows DLLs. You an also link DLLs written in other languages 
into DOS and Windows programs created with Borland Pas¬ 
al with Objects. The new version now includes Object- 
Browsers for both DOS and Windows which allow users to 
navigate source code either by objects or by units. Six new 


compiler optimizations have been added, including 80386 32- 
bit math operations. 

Borland Pasal with Objects v7.0 costs $495 and includes 
the TurboVision and ObjectWindows appliation 
frameworks, WinSight, WinSpector, Resource Workshop, and 
enhanced versions of Turbo Debugger, Turbo Profiler, and 
Turbo Assembler. Current owners of Turbo Pascal for Win¬ 
dows, Turbo Pasal Professional, or Turbo Pasal an upgrade 
for $149.95. As a special introductory offer, the Appliation 
Framework and Runtime Library Source Code is included for 
free. For more information, contact Borland International 
Inc., 1800 Green Hills Road, P.O. Box 660001, Scotts Valley, 
CA 95067-0001. 


Greenleaf Augments Windows Communications 


The normal Windows serial port device driver is limited 
to COM1 through COM4 (C0M1 through COM8 on a PS/2) and 
offers only limited handshaking and less-than-optimal 
throughput. Greenleafs new PowerComm Toolkit for Win¬ 
dows is a DLL and virtual device driver (VxD) designed to 
help overcome these limitations. Appliations using Power¬ 
Comm can use standard or multiport communiation 
hardware under Windows or DOS. The package an support 
any number of ports and any number of appliation instan¬ 
ces. Both Windows and DOS programs running on the same 
system can access different ports on the same multiport 
board. 

Greenleaf has also updated its CommLib communiations 
library. CommLib v4.0 an work with or without Greenleaf 
PowerComm to provide device-independent DOS and Win¬ 


dows communiations. Besides Windows support for a 
variety of file transfer protocols and handshaking, CommLib 
V4.0 provides support under DOS and extended DOS for intel¬ 
ligent multiport boards by DigiBoard, Star Gate, and ArneL 
The library also contains INT 14 interface drivers for BIOS, Ex¬ 
tended BIOS, several kinds of network interface software, a 
special "Fast" driver that helps with special processor-inten¬ 
sive situations, and several additional drivers. 

Greenleaf CommLib v4.0 costs $359. Greenleaf Power¬ 
Comm costs $179. Greenleaf CommLib Professional, which in¬ 
cludes both packages, costs $538. For more information, 
contact Greenleaf Software, Inc., 16479 Dallas Pkwy., Ste. 
570, Dallas, TX 75248, (800) 523-9830 or (214) 248-2561; 
FAX (214) 248-7830. 
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1DC Introduces Library Manipulation Tools 


LibTools is a set of programmer's tools for creating, 
managing, and exploring libraries of object modules. LibTools 
can perform the tasks of a normal library manager faster. It 
also provides wildcard support for filenames and time and 
date stamping of modules to simplify management 
LibTools facilitates library design with extensive report¬ 
ing and cross referencing capabilities. It an resolve public 
symbol conflicts, foreast executable bloat, and verify 
module integrity. LibTools an show a complete list of the 
public and external references in a module to show exactly 
what will be linked in when you all a particular function. 


LibTools’ LibComp utility compares two libraries for dif¬ 
ferences and produces a list of dupliate symbols. You an 
then use LibTools to rename any external and public sym¬ 
bols which conflict Also included is a Library Dump utility 
that lists, in detail, the complete contents of a library. 

LibTools costs $149 and works with Intel, Microsoft, and 
Borland object module formats. For more information, con¬ 
tact Integrated Development Corporation, 190 Main 
Street, P.O. Box 592, Hampstead, NH 03841, (603) 329- 
5522 or (800) 333-3429; FAX (60 3) 329-4841; OS 
70441,2465. 


SlickEdit Adds Mouse and Hypertext 

MicroEdge, Inc, has released SlickEdit v2.3, a 
programmer’s editor available on a variety of platforms. The 
new version includes mouse support for DOS, OS/2, and Win¬ 
dows NT, faster line scrolling for UNIX platforms, and hyper¬ 
text help for all platforms. 

SlickEdit is a full-screen, configurable editor that includes 
a typeless REXX-style macro language and a programmable 
file manager. The editor provides full undo and redo to 
32,000 steps, multiple windows, the ability to edit multiple 
files up to 1Gb, Brief and Epsilon emulation, hypertext help, 
multiple clipboards, compiler error message processing, pro¬ 


cedure tagging, Microsoft C v6.x and v7.x browse support, 
command retrieval, and the ability to edit Macintosh, UNIX, 
and DOS ASCII format files at the same time. SlickEdit's 5,000 
lines of macro source code are completely compatible 
across all platforms. 

SlickEdit costs $198 for OS/2, Windows NT, or DOS; $295 
for DOS bundled with Windows NT or OS/2. For UNIX systems 
the cost is per CPU and starts at $425. For more information, 
contact MicroEdge Inc., P.O. Box 18038, Raleigh, NC 27619- 
8038, (919) 831-0662; FAX (919) 831-0101. 


Agility Introduces Database Manager for 

Agility/VB is a new database manager for Microsoft's 
Visual Basic With Agility/VB, programmers an quickly cre¬ 
ate database appliations using custom controls without 
writing a single line of code. The package includes grid, text, 
button, and picture controls, as well as a set of commands 
that provides complete program control over database ap¬ 
plications. Agility/VB supports dBASE and text file formats, 
and provides its own native database for variable-structure 
and variable-length data storage. 

Agility/VB includes a View Editor that lets you specify 
relationships between multiple databases in a view, even for 


VB 

databases of different formats. Agility/VB lets programmers 
view related databases as a single flat file, while automat- 
ially maintaining all relations and indexes. Views, like the 
other database formats the package supports, an be ac¬ 
cessed by all Agility/VB commands and custom controls. 

Agility/VB costs $189 and requires Windows 3.x and 
Visual Basic 1.x or higher. For more information, contact 
APEX Software Corporation, 4516 Henry Street, Suite 401, 
Pittsburgh, PA 15213-3785, (412) 681-4343. 


WCSC Updates COMM-DRV 

WCSC has released COMM-DRV V12.0, the latest version 
of their professional serial communiation development 
libraries and serial communication tools. COMM-DRV now 
supports Windows 3.x as well as DOS and Desqview. The 
new version supports all dumb multiport ards, the ARNET 
SMARTPORT PLUS series of multiport cards, and the Digiboard 
COMXi series of multiport ards. 

The COMM-DRV Windows API is idential to the DOS API. 
The package includes a realtime serial port monitor that 
provides statistics on all active serial ports, useful for debug¬ 
ging. You an link the COMM-DRV libraries directly into DOS 
or Windows appliations, or use the supplied Windows DLLs 
from your Windows appliations. DOS appliations an also 
link dynamially to the COMM-DRV TSR at runtime. All ap¬ 
plications an communiate with COMM-DRV via its INT 14H 


and FOSSIL interface or via its file I/O interface that is 
mapped to communiation devices. File transfer DLLs and 
libraries are also provided. 

Beause of its design, COMM-DRV allows programs like 
PC-Anywhere IV and Desqview to function with non-stand¬ 
ard multiport ards for true DOS multi-user apability. Its INT 
14H interface allows Procomm/Windows, Procomm/Net- 
work, CompuServe CIM, and many other appliations to func¬ 
tion with non-standard multiport ards. Its file I/O interface 
lets database programmers address the serial ports as nor¬ 
mal DOS files. 

COMM-DRV v12.0 costs $189.95. For more information, 
contact WCSC, 2470 S. Dairy Ashford, Suite 188, Houston, 
TX 77077, (800) 966-4832 or (713) 498-4832; FAX (713) 
568-3334. 
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Windows Graphics for Scientists 

Scientific Endeavors has released GraphiC/Win, a Win¬ 
dows version of its graphics library for C programmers. The 
library includes all of the features of the DOS version for 
creating publication-quality scientific graphics. No Windows 
programming is required, since Graphic creates and manages 
its own window and resources. However, all the source code 
needed to customize the Graphic window and resources is 
provided. 

GraphiC/Win can create Windows metafiles and bitmaps 
and copy both to the Windows clipboard. Routines are also 


SpeedPack II Gives BP 32-bit Speed 

SpeedPack ll is a library designed to help Borland Pascal 
programmers increase the performance of their DOS or Win¬ 
dows Pascal programs. To speed up applications, SpeedPack 
II lets programmers dedicate applications for 16-bit or 32-bit 
platforms. The System unit in the runtime library has been 
completely rewritten to take advantage of 32-bit CPUs. A 
one-step utility lets you choose platforms on the fly while 
using the Borland IDE. You simply recompile your application 
to take advantage of 32-bit performance without changing 
any source code. SpeedPack II includes an additional System 
unit to increase 6-byte real floating-point performance and 
precision. 


available to prompt for and to accept input GraphiC/Win 
stores its graphics in compact, high-resolution Tektronic 
4105 format These files are available with many mainframe 
environments. In addition, GraphiC/Win can export graphics 
in Postscript (color and black and white), GEM, Lotus PIC, 
HPGL, HPGL/2, and TIFF formats. 

GraphiC/Win costs $495. For more information, contact 
Scientific Endeavors Corporation, 508 North Kentucky 
Street, Kingston, TN 37763, (615) 376-4146 or (800) 998- 
1571, FAX (615) 376-1571. 


The System units speed up math, reals, strings, num¬ 
ber/string conversions, text file I/O, file access, sets, heap al¬ 
location, and memory transfer. The package also includes a 
high-speed string unit with 122 string-processing routines all 
written in assembler. The Windows version includes a 300- 
topic help file with cut-and-paste examples for each routine. 
Complete source code is included. 

SpeedPackll costs $99. For more information, contact 
Eagle Performance Software, TC Products Division, P.O. 
Box 292786, Lewisville, TX 75029-2786, (214) 539-7855. 


TesSeRact CXL Now Supports Windows 

TCXL/Windows is a user interface that lets developers 
create applications for both DOS and Windows with one set 
of source code. TCXL/Windows works with The TesSeRact 
CXL User Interface Development System (TCXL). TCXL/Win¬ 
dows transparently handles Window system calls, message 
loops, and nonprocedural callback procedures. 

Any TCXL application ran be converted into a native Win¬ 
dows application by making a simple change to a single line 
of code and rebuilding. Programs converted in this way 


Dyad Updates M++ Math Class Library 

Dyad Software has released M++ v4.0, a new version of 
their C++ mathematical class library. The new version adds a 
complete set of spectral operations, a BitArray class, a 
PointerArray class, Huge memory pointers for DOS users, and 
an extensive set of assembly language Basic Linear Algebra 
routines (BLAs). 

The spectral methods allow the user to perform FFTs on 
vectors or arrays of vectors, as well as multidimensional FFTs 
(up to four dimensions). The user ran also select from 
methods for convolving two vectors or two matrices. The 
package also includes methods for performing HR and FIR fil¬ 
tering on vectors. 

The version 4.0 BLAs provide speed increases of up to 
eight times faster than C code for some operations with Intel 


retain the TCXL-DOS look and feel. If you code your applica¬ 
tion using TCXL's new TUI routines, it will be indistinguish¬ 
able from other Windows applications. 

TCXL/Windows costs $69, or $99 with TCXL-DOS (which is 
required). For more information, contact Innovative Data 
Concepts, 122 North York Road, Suite 5, Hat boro, PA 
19040, (215) 443-9705 or (800) 926-4551; FAX (215) 443- 
9753; CIS 75300,564. 


machines. The new BitArray class provides an array of direct¬ 
ly addressable bits with special bit operations. The new 
PointerArray class lets users select arrays of varying type. A 
Huge memory pointer gives both Borland and Microsoft com¬ 
pilers the use of large arrays. The Huge pointer ran be used 
without Windows for arrays of up to 640Kb and with Win¬ 
dows for arbitrarily large arrays. M++ for DOS C++ compilers 
(including Borland, Microsoft, Zortech, and MetaWare) costs 
$495; M++ for various UNIX, Windows NT, and OS/2 compilers 
costs $695. For more information, contact Dyad Software, 
515 116th Ave. NE, #120, Bellevue, WA 98004-5204, (206) 
637-9426. 
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1992 Fall COMDEX Report 



Ron Burk 

® 

This was my first COMDEX and it was, as most everyone had described its 
predecessors, organized chaos on a grand scale. The biggest challenge was trying to 
track down all the software vendors relevant to DOS and Windows programming — 
they were scattered around Las Vegas with no discernible design. The supplied index 
of vendors and products was of questionable help. For example, the entry for 
“SOFTWARE: Compilers" omitted a few minor compiler vendors such as Microsoft, 
Borland, Symantec, and WATCOM! Therefore, with apologies to the vendors I missed, 
these are my notes on the 1992 Fall COMDEX. 

IBM and Microsoft were both out in force, as expected. With the ship date for 
Windows NT still fuzzy, Microsoft tried to bolster confidence with rows of Inde¬ 
pendent Software Vendors (ISVs) demonstrating Windows NT versions of their 
products. The “waiting for NT” movement was in contrast to IBM's ISVs, who had 
products ready for an operating system that is already shipping. On the other hand, 
more than one person pointed out that Microsoft gave nearly all its prime COMDEX 
real estate (right by the front door) to its ISVs, while IBM tucked its players away in 
relative obscurity. This kind of support no doubt contributed to the fact that most of 
the would-be NT vendors seemed content with the operating system’s receding 
release date. Having no operating system of his own to sell, Philippe Kahn of Borland 
flew overhead in a biplane, towing banners with various messages of Borland 
boosterism. 

You could see a copy of the book Inside Windows NT from Microsoft Press at the 
show, but you couldn't buy it — the book has been selling so quickly that MS Press 
only managed to bring a handful of copies. The main function of the booth person¬ 
nel seemed to be to try, unsuccessfully, to prevent book theft. 

The large array of Windows NT ISV booths contained some interesting omens of 
future compiler wars. WATCOM has beta programs for the NT versions of both their 
Fortran and their C compilers. In the Windows arena, WATCOM has offered 32-bit DOS 
and Windows compilers, which allows them to avoid taking on Microsoft and Bor¬ 
land directly and to focus on an important market niche of compute-intensive ap¬ 
plications. In the future NT market, however, all the compilers will be 32-bit, and 
WATCOM should have a bit of a head start in quality, 32-bit code generation. 


Ron Burk has a BSEE from the University of Kansas and has been a programmer for 
12 years. He is working on a book tentatively titled WinHelp for Programmers and 
Technical Writers. You may contact him at Burk Labs, P.O. Box 3082, Redmond, WA 
98073-3082. CIS: 70302,2566. BIX: rlburk; Internet: ronb@rdpub.com (“. . . 

luunetlrdpublronb") 
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On a related front, DEC was in the NT ISV area demonstrat¬ 
ing their C++ compiler running on an Alpha. This was of inter¬ 
est for two reasons. First, the Alpha could turn out to be a 
great platform for developing Windows programs — how does 
150 MIPS sound for dealing with those deathly slow Microsoft 
Foundation Classes compilations? Second, since DEC has NT 
running on the Alpha, can it be long before their C++ compiler 
winds up on an Intel Windows NT platform? I have heard 
some good things about their compiler (they already have 
both templates and exceptions implemented), and having a 
serious contender like DEC in the PC C++ market could only 
mean lower prices and higher quality. 

Waiting with bated breath for Microsoft to introduce a 
Visual C++? Take a look at GUILD, yet another GUI develop¬ 
ment tool but with a Visual Basic kind of slant. You get some¬ 
thing similar to VB's properties, methods, and events, and you 
can call your own C functions for the hard stuff. A key point is 
that you can call C functions in your executable —you are not 
restricted to calling DLL functions. Your application can also 
call back to a variety of functions in the GUILD engine. I 
haven’t seen another tool with quite this approach, and the 
product was being demonstrated on Windows NT (it already 
runs on Windows 3.x and OS/2 2.0). 

Are you a UNIX programmer reluctantly considering getting 
your feet wet in Windows NT? The Hamilton C Shell, despite 
the name, includes much more than just a command inter¬ 
preter. The package contains enough UNIX work-alike utilities to 
make any UNIX programmer feel at home under Windows NT. 


Source Code Availability 

Bulletin Board Systems 

Phoenix Chapter 
ACM Library 

(602) 9Z0-04Z4 

The 

Programmer’s 

Corner 

(301) 596-7692 or (410) 995-6873 

The Courts of 
Chaos 

(501) 985-0059 

EmmaSoft 
Shareware Board 

(607) 533-7072 

Cornerstone 

(206) 362-4283 

Other Systems 

CompuServe 

GO CLMFORUM, section 7 

BIX/WIX 

join listings, change areas to 
''win.dos.dev’’ 

uunet 

~/published/windowsdos/19YY/monYY.zip 
Accessible via anonymous FTP from 
ftp.uu.net or via uucp from 
(900) GOT-SRCS (login name “uccp”, no 
password, $.50 per minute). 


CCC/Manager v2.1 was also in the NT ISV area, now running 
on Windows NT in addition to Windows 3.x and OS/2 2.0. 
CCC/Manager is for large-scale software project management, 
and includes support for distributed environments and concur¬ 
rent development. 

How many NT development tools cost no more than a 
phone call? Phar Lap's QuickStart for Windows NT is still free 
and now you can use it with Win32s, since the latest NT 
CDROM has a preliminary version of the Win32s libraries. 
QuickStart lets you run the NT development tools (e.g., 32-bit 
compiler) from a DOS shell. Without QuickStart, if you wanted 
to build a Win32s application, you would compile and link 
under Windows NT, then boot up Windows 3.1 to test it with 
Win32s. With QuickStart, you can compile and link from a DOS 
shell under Windows 3.1. QuickStart does not promise to be 
free forever, so check with Phar Lap for the latest status. Phar 
Lap also announced that Microsoft’s FoxPro v2.5 for DOS uses 
the Phar Lap 3861 DOS-Extender to give it that 32-bit speed 
under Windows 3.x enhanced mode. 

No Windows NT gathering would be complete without 
SlickEdit, which must hold some kind of record as the longest- 
shipping product for an unreleased operating system. SlickEdit 
is a programmer’s editor available for DOS, OS/2, SCO UNIX, 
Interactive, 386-based System V UNIX, Sun Sparc, HP9000, and 
other UNIX-based platforms. The editor was running at the 
show on three different NT platforms: Intel, Mips, and the DEC 
Alpha. 

It seems like you can't pick up a newspaper without read¬ 
ing about Microsoft, but I still run into people who haven't 
heard of Computer Associates, one of the biggest software 
companies around. In case you haven’t heard, CA is not just 
into mainframes anymore. At COMDEX they demonstrated the 
second version of CA-dBFast, a very visual way to create Win¬ 
dows dBASE applications with minimal resorting to coding. 
You can grab your existing XBASE code, convert it instantly to 
a Windows application, and then incrementally add all the 
bells and whistles to remove that fixed-size, character-mode 
look and give it the shiny, graphical, Windows look. Computer 
Associates also acquired REALIZER, a procedural BASIC way to 
develop Windows applications. They had CA-REALIZER up and 
running on Windows NT. 

The Association of Shareware Professionals hosted some 
shareware tools for programmers. EmmaSoft was in the booth 
with SUPER-MAINT, their deluxe make utility for DOS. I also saw 
DMalloc 1.0, a malloc() debugger for large-model, DOS, 
Microsoft C programs. You can grab copy from CompuServe 
(MSLANG, library 3, DML100.ZIP) and "try before you buy.” 

V Communications had a new version of Sourcer, their pro¬ 
gram disassembler, promising ever faster and more thorough 
disassembly. Who uses this stuff? Well, Paul Bonneau has al¬ 
ready put their Windows Source (which is Sourcer plus a spe¬ 
cial Windows add-on) to use in poking around dark alleys to 
answer questions in his column. 

Bravely ignoring the possibility of permanent hearing loss, I 
headed into the convention center that hosted all kinds of 
multimedia products. Incongruently, in the midst of the multi- 
media exhibits was Blue Sky Software, makers of 
WindowsMAKER Professional. Like a good many other Win¬ 
dows development tools, WindowsMAKER Professional 
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appeared on Windows NT. Blue Sky was also demonstrating 
Visual SQL, an upcoming tool that basically does for building 
Windows SQL applications what WindowsMAKER Professional 
does for building the Windows user interface. After you inter¬ 
actively design and test your Windows SQL application, Visual 
SQL can generate the necessary C source code, complete with 
embedded SQL calls, to implement the application. Blue Sky 
also has a new release of RoboHELP in the works. Due to the 
number of nonprogrammers implementing Windows online 
help systems, the new RoboHELP promises a kindler, gentler 
user interface. 

Also in the multimedia area, I found Walnut Creek CDROM, 
folks who put large collections of programs and source code 
on CDROM. We have a short look at their offerings for 


programmers on page 39 of this issue. If you thought that 
CDROM drive would never be good for anything but installing 
endless prereleases of NT, think again. 

Coromandel was another windows NT hopeful, with their 
ObjecTrieve for Windows NT. ObjecTrieve is a portable, multi¬ 
user, ISAM-based data management tool that works on DOS, 
Windows, and UNIX. The company was also demonstrating 
QBE Vision, a query tool tool that you can also use to develop 
applications, since it contains a scripting language that 
provides access to the functionality of the Windows API. 

Another contender in the windows database application 
construction business was Mozart, a toolkit for building 
client/server applications. Mozart interacts with ORACLE, SQL 
Server, Database Manager, and any host 3270, 5250, or 



Developer's 

Marketplace 


2 tm 

The Art ot Visual Basic Programming ™ 

This amazing new book by J. D. Evans, Jr. unlocks 
the secrets of Windows and Visual Basic 
application design and programming. It explains 
Windows design from a unique and easy to 
understand perspective. Smart Objects, Hybrid 
Objects, Control Coupling, Events, Focus, Event 
Triggering, Visibility Form and Module Code 
Placement, DLL Parameter Passing, Variable 
Scope, Strings, and Structures are described and 
explained. Enlightening allegories and annecdotes 
make this one of the most unusual and informative 
Windows books ever written. This book is the 
Rosetta stone for Windows and Visual Basic! 


Book: $29.95 Companion Disk: $9.95 


ETN Corporation 

RD4 Box 659 Montoursville, PA 17754-9433 
(717) 435-2202 (Sales) (717) 435-2802 (FAX) 
AMEX/MC/VISA/Check/MO/PO/COD 
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NETWORK 

CONTROL 

LIBRARIES 

NETBIOS ROUTINES allows ac¬ 
cess to low-level network func¬ 
tions. Name, session, and 
datagram routines. Wait and no¬ 
wait options. $99 

NETBIOS DLL for Windows $199 

NETWORK MASTER provides 
access to Netware internal func¬ 
tions. Complete network control 
from your compiled programs! $99 

Starlight Software 

P.O. Box 1090 
Wheeling, IL 60090 

(708) 394-0622 _ 
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COM1: - COM4: WITH W1NDOWSI 

1,2. OR 4 PORT RS-232 BOARDS 
RS-232 AND RS-422 VERSIONS 
XT AND AT INTERRUPT JUMPERS 
OTHER PRODUCTS INCLUDING LAPTOP 
ADD-ONS 

DELIVERY FROM STOCK 
MADE IN USA 

EXCELLENT TECHNICAL SUPPORT 


SE ALEVEL SYSTEMS INC. 
P0B0X63O 
UBERTY.SC 29657 

603-843-4343 
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SpyWorks-VB 

For Visual Basic™ - Windows 

SpyWorks-VB allows you to do virtually 
anything in Visual Basic that is possible 
using other languages such as C. It 
includes controls that easily subclass 
VB forms and controls, detect keyboard 
events, and support callback functions. 
SpyWorks includes debugging tools to 
view message and event history, detect 
API parameter errors. Browse Windows 
memory and resources, and retrieve 
information about any window, form or 
control in the system. 

SpyWorks-VB is only 4129 + $5 s&h (415 
outside U.S & Canada). Visa/MC orders 
include phone and exp. date. CA residents 
add 8.25% sales tax. Dual media - Requires 
VB2.0 

Desaw are 

5 Town & Country Village #790 

San Jose, CA 95128 

(408) 377-4770 fax:(408) 371-3530 

□ Request 113 on Reader Service Card □ 



Image Compression 
for Windows 

+ Compress/Decompress images in 
10 seconds or less. 

Full Source Code & DLL's Available 

* Convert & View Multiple Images 

•k Royalty Free Developers Kit Available 

* PRICES START AT $99.00! 

Regular and Extended Dos also available 
•B PHONE: 1-800-966-4487 
305-962-9961 
FAX: 305-962-6546 

Information Technologies Research,Inc 
3520 W Hallandale Beach Blvd 
Pembroke Park, FL 33023 
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Asynchronous protocols. Of course, it now runs on Windows 
NT in addition to Windows 3.x an OS/2 2.0. 

ProtoView Development Corporation announced an arran¬ 
gement with Borland to sell its new ProtoGen Pascal, a code 
generator and prototyper that brings to Pascal features found 
in the company's ProtoGen for C++. ProtoGen Pascal is avail¬ 
able from Borland for $49.95. 

XVT, one of the most portable GUI development tools, was 
running on Windows NT at the show. XVT is offering their 
XVT/NT Toolkit to help developers take advantage of windows 
NT and still remain portable. The toolkit promises Win32s sup¬ 
port to let you build Windows NT applications that can still 
run on Windows 3.x with the Win32s DLLs. This will be an 
increasingly important issue as programmers begin to realize 
that the Windows 3.x market will remain larger than the Win¬ 
dows NT market for some time to come. 


CASEWORKS was at the show with their line of CASE tools 
for creating Windows applications. They announced that the 
CASEWORKS Intro Edition for Microsoft Foundation Classes will 
be bundled with the Microsoft C/C++ v7.0 compiler. 

By Friday, the temperature had dropped and the wind 
kicked up sandstorms that blasted attendees as they stag¬ 
gered from one convention center to another - an unneces¬ 
sary incentive to call it a day and pack our bags. During the 
conference, I was amazed at the number of folks at the $25- 
and $ 100-minimum blackjack tables. I wondered if that meant 
that the computer industry was on the rebound, or if things 
were so bad that CEOs were deciding to bet the last company 
dollars in the casino. Playing the slot machines at the Mirage 
for an hour made the software business seem like a risk-free 
endeavor, so I returned home to bang out code with renewed 
vigor. □ 



Developer's 

Marketplace" 


Windows 
Developer Jobs 

Specialists in jobs for software 
engineers in leading edge technology. 
Windows, PM, GUI, Languages, AI, 
Mac, CASE, Video, Realtime. 
Nationwide contacts with both large 
and small companies including equity 
startups. Many of our clients develop 
and publish commercial software 
products. Managed by graduate 
engineers. Never a fee to an 
applicant. 


o 


1 - 800 - 231-5920 
Scientific Placement, Inc. 

SPI-8, Box 19949, Houston, TX 77224 (713) 496-6100 
SPI-8. Box 71, San Ramon. CA 94583 (510) 733-6168 
SPI-8, Box 4270, Johnson City. TN 37602 (615) 926-6188 
Fax: 713-496-6802 please use Fine Setting on Fax 
Email: Ascii preferred: Internet LSH@Scientific.com; 
\ Compuserve: 71250,3001; Genie: D.SMALL6 _ J 
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These Incredible Tools 
Make Windows. 
Easy To Use. 


■ Central™ ....Amazing-Organizes Your Com¬ 
mands, Programs, and Files.$39** 

I WlndList™ .SuperTask Manager 

(Control Any Window).$39** 

iMagWInd™ . Magnify The Screen 

(The Easy Way).$19^ 

iBUVlew™ ...See The Internal 
Structure of Bitmaps.$15** 

iBtnAid™ ....Program 3-D Buttons 
(Graphics, Text, and Frames).$59** 


Springtime Software 

81 Amherst Avenue 
Waltham, MA 02154 


□ Request 119 on Reader Service Card □ 


Fast Way To 
Windows 


Lei our MS-Windows specialists: 

- PORT pour existing application 

- DEVELOP a device driver 

- PROVIDE training and support 

DOS, MS-Windows 3.x 
Windows NT 

1-800-944-5468 


-fr 

□ 
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SimteIZO MSDOS CDROM* $24.95 

640 megabytes in 9000+ files. Programming tools, DOS 
utilities, tech docs, comm, bbs, publishing, ham-radio, 
education, and much more. Dated September 1992. 


CICA MS Windows CDROM* $24.95 

Hundreds of MS Windows programs. Utilities, games, 
source code, and programming tools. Dated July 1992. 

Source Code CDROM* $39.95 

X11R5 and GNU CDROM $39.95 

Info-Mac CDROM* $39.95 

GIFs Galore CDROM $24.95 

OS/2 Archive CDROM* $24.95 

AB20 Amiga CDROM* $24.95 

Garbo MSDOS/MAC CDROM* $24.95 
CDROM Caddies $4.95 

*Shareware programs require separate payment 
to authors if found useful. 


Walnut Creek CDROM 



1547 Palos Verdes Mall 
Suite 260 
Walnut Creek, CA 94596 

+ 1-800-786-9907 

+ 1-510-947-5996 
FAX +1-510-947-1644 
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Opt-Tech Sort/Merge 


Extremely fast Sort / Merge / 
Select utility. Run as an MS- 
DOS command or CALL as a 
subroutine. 

Supports most languages and 
filetypes including Btrieve and 
dBase. Unlimited filesizes, mul¬ 
tiple keys and much more! 

MS-DOS, Windows $149. 
OS/2, UNIX $249. 


Opt-Tech Data Processing 

P. O. Box 678 
Zephyr Cove. NV 89448 

(702) 588-3737 
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eXtraHelp 

Windows Developer: You have just 

delivered your Windows Application and the user 
is now requesting context-sensitive help. With 
eXtraHelp you can provide help without adding a 
single line of code to vour program . eXtraHelp is 
a simple cost-effective method for providing easy 
to use professional looking help. 

End-User: You have just received your 

Windows Application. The help system explains 
how the program works but there is no help for the 
unique way your company uses it. eXtraHelp is 
the tool that allows you to create context-sensitive 
help specific to your requirements. 

Features: Hyper-Text, paragraph formatting, 
multiple fonts, tabbing, color text , pictures and 
works with any windows program . Microsoft Help 
compiler and RTF editor not needed. $79 per 
copy. Please call or write for site license, quantity 
discount or developer pricing. 

Timenetics Inc. 908-464-5978 

39A WestviewAve. New Providence, N.J. 07974 
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FAST TEXT SEARCH 
for C / Windows 


The fastest, easiest and most versatile way to 
add full text search capabilities to your C and 
Windows applications, FAST TEXT SEARCH 
for C is a function library enabling rapid 
searches of both structured and unstructured 
textual data with low overhead/memory 
requirements, low cost and high efficiency. 
Great with CodeBase, SoftC, AccSys, etc. 
No Risk 30 day Money Back Guarantee 

Order-(800) 334-8099 
Only $189.00 

Windows/DOS Developer’s Journal Special includes 
UltraSearch & Free 2 Day Shipping 

DOS (Microsoft, Borland) and OS/2 libraries 
& Windows DLL, royalty free integrator license, 
complete printed documentation, sample 
programs & free technical support. 
VISA/MasterCard/COD/Qualified PO s accepted. 



Index Applications Incorporated 

8546 Broadway, Suite 208 
San Antonio, TX 78217 USA 
512 / 822-4818; fax: 512 / 828-5074 
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BRIEF COMPATIBLE 
EDITOR ON UNIX & 
WINDOWS-NT 

c 

Feature rich environment. 
Extremely easy to use. 

R 

100% Keystroke Emulation. 
Run Existing BRIEF macros. 
Specify BRIEF/Unix regexp. 

I 

MultiWindow Xvi emulation. 
Goodbye VI/EMACS!! 

S 

Available On: 

SUN/SCO/HP/I BM/SGI/INT/NT. 
Openlook/Motif/Windows/Char ver. 

p 

Call: VITAL at (713) 781-7406 

3 roduct names are trademark of respective holders 
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Visual Basic, 
BASIC, and PDS 
programmers! 

Purpose Toolboxes 

.<5fSptiics 
n Design 

rfrflfftnunications 



.jsstSfii' Printing 
,»»rStBnfific Applications 
and more! 

Crescent Software offers many tools for 
QuickBASIC, PDS, ond Visuol Basic. All 
products include complete source code, 
free technical support, and royalties ore 
never required! K* ITHANH i RH 00*5 PAOACfS 

CALL TOLL FREE 

1 800 35 BASIC 

CRESCENT SOFTWARE. INC. 

_ 11 BAILEY AVENUE 

crescent RIDGEFIELD. CT 06877-4505 
- 203 43! 5300 FAX 203 4314626 


Does your company provide 
tools, products, or services 
for advanced Windows 
programmers? 

Then reach over 27,000 
serious programmers in: 

Windows/DOS 

□ DEVELOPER'S JOURNAL 

Call 913-841-1631 today for 
information about advertising 
opportunities in Windows/DOS 
Developer’s Journal. 

Advanced. Serious. 
Technical. 

Ed - East Donna - Midwest Edwin - West 


TUB “ is FASTEST! 



RCS’“ 4.2 PVCS’“ TUB’" 3.0 TUB 1 " 5.0 


Times are to update a 45K library on a PC/XT. PVCS and TUB 3.0 are 
from Sept 87 PC Tech Journal. MKS RCS 4.2 and TUB 5.0 are newer. 

TUB™ is BEST! 

"Do not be fooled by the fact that this is the 
least expensive of the five packages reviewed 
here - TUB has features and power to spare" 
John Rex, Computer Language 
“TUB is a great system" J. Vallino, PC Tech J 

• Full-Featured Version Control for Software 
Professionals. Check-in/out locking. Branching. 
Keywords. Wildcard and list-of-file support. Can 
merge parallel changes and undo intermediate 
revisions. Network and WORM support. Main¬ 
frame compatible deltas for Pansophic, ADR, IBM, 
etc.. Integrates with Opus’" MAKE & Slick’" MAKE. 

MS-DOS $139, OS/2 $195 + shipping visa mc 
5 station LAN license $419 (OS/2 $595), call for other sizes 

BURTON SYSTEMS SOFTWARE 

PO Box 4156, Cary, NC 27519 (919)233-8128 
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NETBIOS MADE EASY! 

FOR WINDOWS 3.X 

_ □ Shared DLL resources 


The 

Sigma 

NetBIOS 

Tagine 


□ 


Create High 
Performance 


Network 

□ 

Applications 


FAST! 

□ 


□ 

60 Day Money 

Back Guarantee! 

□ 


supports multiple applications 
and instances. 

Full post processing support 
& notification via messages 
(wait no-wait and polled). 
Complete NCB and attached 
data buffer functions simplify 
memory management 
Complete documentation and 
on-line API help reference. 
Control panel utility allows 
dynamic DLL configuration. 
WINDOWS.TXT compatibilty 
for DOS support 
No royalties, full source and 
demo programs $155.00! 


SIGMA SOFTWARE RESEARCH 

702 Windridge Dr 
Atlanta, GA 30350 

TEL (404) 992-0636 

Also available at the Programmer's ConnectionI 
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C and C++ DOCUMENTATION 


! AUTOMATED DOCUMENTATION! 

• C-CALL ($69) Graphic-tree of caller/called 
functions, cross-ref, file/function index. 

• C-CMT ($69) Creates/inserts/updates 
comment-blocks for each function, listing 
the functions and identifiers used by it. 

• C-METRIC ($59)Counts path complexity, 
counts comments, code, 'C' statements. 

• C-LIST ($69) Lists and action-diagrams, 
or reformats into standard formats. 

• C-REF ($59) Creates cross-reference of 
local/global/define/parameter identifiers. 

• SPECIAL : C-DOC ($199) All 5programs 
integrated as DOS program (<15,000 lines) 

• NEW! C-PQC Pr ofe ssi ona l ($299) 

DOS, OS/2, Windows. 3-ring binder/case. 
Processes 150,000 lines, deferred reports. 


• 30-DAY Money-back guarantee CALL NOW 


SOFTWARE BLACKSMITHS INC. 

6064 St Ives Way, Mississauga 
ONT, Canada Voice/Fax (416)-8! 
L5N-4M1 Demos/BBS I4T6H5! 


see AD INDEX for our larger ad 


CADI CAM 

RECRUITERS INC. S “ 


Our client seeks the best in software en¬ 
gineers for career oriented challenging 
positions. Explore the opportunities! All 
types of programmers needed including 
CAD/CAM software development 
(geometric modeling, NURBS, Curves 
and surfaces, Meshing, FEA, CNC, 
Visualization, Machine Controller, OOP, 
PLC’s, ACIS, etc. Also CATIA, 
Unigraphics, Intergraph, Pro/E, CAD AM, 
CV, etc. Please send detailed resume in¬ 
cluding salary history and geographic 
preferences to: Bill Wright, CAD/CAM 
Recruiters, Inc., 3400 High Hamptons Rd., 
Ste. 841, Charlotte, NC 28210. (704) 541- 
1100. All positions are direct/permanent 
(not contract) and relocation and fees are 
paid. Confidentiality assured. Since 1981. 


February 1993 
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FREE 

Product 

iformation 

Use this postage paid 
card to stay up-to-date 
on products 
that affect 
your productivity. 

Just fill out the card 
and drop it in the mail. 
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WindowsyPOS 

□ DEVELOPER'S JOURNAL 


1601 W. 23rd St„ Suite 200 
Lawrence, KS 66046-9950 
(913) 841-1631 FAX: (913) 841-2624 


Please help us serve you by 
answering the following: 

1) I program: 

□ for a living 

□ as a hobby 

□ as a manager 

2) I program in: 

□ MS-DOS 

□ Windows 

3) I program most frequently in: 

□ C+ + 

□ Assembly 

□ Pascal 

□ BASIC 

□ C 

□ Other _ 

D Please send me subscription information. 


REOUEST READER SERVICE NUMBERS: 



Windows/POS 

□ DEVELOPER'S JOURNAL 

□ YES! Send me 12 issues of Wmdows/DOS Developer’s Journal for only $29! 

□ 2 years (24 issues) for $54 □ 3 years (36 issues) for $77 

□ Bill Me [H Visa □ MasterCard 

Number_Exp._ 

Signature_ 


Name 


Company 


Address 

City 

State 


Zip 


Country/ProvincelMailcode 


4.2 


Please allow up to six weeks for delivery of first issue. Orders outside the US must be prepaid in US funds. CANADA/MEXICO 
subscriptions are: 1 year - $53; 2 years - $88; 3 years - $121. Overseas subscriptions are: 1 year - $64; 2 years - $120; 3 years - $174. 
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There is a good reason why 
• your database language was 
developed in C. In fact, there 
are many good reasons. 

C code is small. C code is fast. C code is 
portable. C code is flexible. C is the 
language of choice for today's professional 
developer. With the growing complexity of 
database applications, C is a realistic 
alternative. Now with CodeBase 5.0, you 
can have all the functionality, simplicity and 
power of traditional database languages 
together with the benefits of C/C++. 

C speed ■ fast code, true executables... 

FoxPro, Clipper, and dBASE were written 
in C primarily for speed. But those compilers 
don't really compile, they combine imbedded 
language interpreters into your .EXE. Now 
that's slow. For dazzling performance you 
need the true executables of C. With 
CodeBase you get the real thing, C code. 
Consider the following statistics, from the 
publisher of Clipper: 


slower 



dBASE IV 
FoxPro 
Clipper 5 


"Sieve of Erastothenes" 

Benchmark for Prime Number Generation 
Shows C to be incredibly faster! 

C size - small executables, 
no added overhead... 

FoxPro, Clipper and dBASE would like you 
to believe you need their entire development 
system to build database applications. But 


remember, those products are all written in 
C. So why do you need to lug all their extra 
code around? You don't. CodeBase is a 
complete DBMS, in C. No fat executables 
stuffed with unused code. No runtime 
modules. No royalties. Just quality C code. 
CodeBase is just what you need. 

C portability ■ ANSI C/C++ 
on every hardware platform... 

No other language exists on more platforms 
than C/C++. Why rewrite your entire 
application for DOS, Windows, Windows 
NT. OS/2 or UNIX? With CodeBase the 
complete C source code is included, so you 
can port to any platform with an ANSI C or 
C++ compiler. Now and in the future. 

dBASE Compatible data, index 
and memo files... 

You want the industry standard. You need 
compatibility. Sure, dBASE is the standard, 
but every dBASE compatible DBMS 
product uses its own unique index and memo 
file formats. Only CodeBase has them all: 
FoxPro (.cdx), Clipper (.ntx), dBASE IV 
(.mdx) and dBASE III (.ndx). Now it's your 
choice, we're compatible with you. 

Announcing 
CodeBase 5.0 

The power of a complete DBMS, the benefits of C 

NEW ■ Multi-user sharing with 
FoxPro, Clipper and dBASE... 

Now your multi-user C/C++ programs can 
share data, index and memo files at the 
same time as concurrently running FoxPro, 
Clipper and dBASE programs. No 
incompatibilities. No waiting. 

NEW - Queries & Relations 
1000 times faster... 

CodeBase 5.0 now lets you query related 


data files with any logical dBASE expression. 
Our new Bit Optimization Technology 
(similar to FoxPro's Rushmore technology) 
uses index files to return a query on a 1/2 
million record data file in just a second. 
Automatically take advantage of this query 
performance by using our new CodeReporter: 



program you write. Call 403/437-2410 now for 
your FREE working model of CodeReporter. 

New - Design complex reports 
in just minutes... 

Our new CodeReporter takes the painstaking 
work out of reports. Now simply design and 
draw reports interactively under Windows 3.1, 
then print or display them from any DOS, 
Windows or UNIX application. 

SPECIAL - FREE CodeReporter 

Order CodeBase 5 before April 30, 1993 
and receive CodeReporter for free! This 
offer includes our no-risk, 90-day money 
back guarantee, so order today! 

CooMase 3.0 

The C/C++ Library for DataBase Management 

Call Now 
403 - 437-2410 



SEQUITER I 

SOFTWARE INC. 1111 


FAX 

Europe 


403*436*2999 

33.20.24.20.14 


#209,9644-54 AVE., EDMONTON, AB, CANADA T6E-5V1 


01992 Sequiter Software Inc. All rights reserved, CodeBase is a trademark of Sequiter Software Inc. All other trade names referenced herein are property of their respective companies. MAdvertising by MicroArts 
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New BOUNDS-CHECKER 2.0 



Welcome to the age of 
automated memory/heap protection! 

NEW BOUNDS-CHECKER 2.0 is the finly complete solution to MS-DOS 
memory and heap corruption problems. 

BOUND-CHECKER 2.0 is a single, easy to use utility that automatically 
detects problems in your programs heap, stack or data segment and 
finds illegal memory accesses outside of your program or in your code. 
In one step, you can quickly and easily flush out some of the most 
insidious bugs that you regularly encounter as a DOS programmer. 


• New 2.0 Features • 

• Now works with 3rd party memory managers 

• Heap, stack and data segment checking 

• Smart Mode decides the legitimacy of an access automatically 

• No need to see assembly code - call stack lets you view source 
of calling routines. 

• New Auto Log mode (BC doesn't pop up) 

• Supports C7.0 & Borland 3.1 & VROOM 

Order NOW! Only $199 


Using BOUNDS-CHECKER 2,0 is simple, there are no changes to be made 
to your source in any way, and no linking of code or macros into your 
executable. When a bug is found, BOUNDS-CHECKER pops up showing 
you precisely where the problem is. 

One of its innovative NEW features is Smart Mode. Smart Mode uses a 
built-in knowledge base to automatically determine if an out-of-bounds 
access is legitimate. This eliminates any complex decisions on your part, 
resulting in more power and flexibility than you may have thought 
possible. 

Don't take unnecessary risks with your program or your customers. 
BOUNDS-CHECK before you ship with NEW version 2.0. 


For even more debugging power, BOUNDS-CHECKER 2.0 
integrates with our award-winning Soft-ICE debugger which fea¬ 
tures powerful 386/486 based breakpoints. Equipped with this 
formidable combination, your de-bugging arsenal is prepared for 
any surprise attack of the DOS Nasties. 

Soft-ICE...$386 

BOUNDS-CHECKER 2.0 & Soft-ICE Bundle Only...$499 

BOUNDS-CHECKER AND SOFT-ICE ARE TRADEMARKS OF NU-MEGA TECHNOLOGIES, INC. 


We're making C a Safe Language! 


Call (603) 889-2386 
fax (603) 889-1135 
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30 DAY 

MONEY-BACK GUARANTEE 

P.O. Box 7780 

Nashua, NH 03060-7780 U.S.A. 

TECHNOLOGIES INC 

24 HOUR BBS 
603-595-0386 
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